1. 问题现象与背景解析最近在项目中使用MyBatis-Plus操作MySQL数据库时遇到了一个关于生成列Generated Column的更新异常问题。具体表现为当执行实体类更新操作时如果实体类包含了数据库表中定义的生成列字段即使没有主动设置该字段值MyBatis-Plus也会尝试更新这个字段导致抛出Generated column cannot be updated的SQL异常。生成列是MySQL 5.7版本引入的特性它允许在表中定义自动计算的列如基于其他列的计算结果。这类列的值由数据库自动维护应用程序不应直接插入或更新。例如CREATE TABLE product ( id BIGINT PRIMARY KEY, price DECIMAL(10,2), tax_rate DECIMAL(4,2), total_price DECIMAL(10,2) GENERATED ALWAYS AS (price * (1 tax_rate)) STORED );在这个例子中total_price就是一个生成列它的值会根据price和tax_rate自动计算得出。2. 问题根因分析2.1 MyBatis-Plus的更新机制MyBatis-Plus的update操作默认会尝试更新实体类中的所有非null字段。其底层实现逻辑是通过反射获取实体类所有字段值排除null值字段构造包含剩余字段的UPDATE语句对于常规字段这种机制没有问题。但对于生成列即使我们没有显式设置它的值由于它在Java实体类中有对应字段MyBatis-Plus仍会将其包含在UPDATE语句中。2.2 生成列的特殊性生成列在数据库层面有以下特点值由数据库自动计算不允许手动更新在INSERT语句中可以完全省略在UPDATE语句中如果包含会抛出错误这与MyBatis-Plus的默认行为产生了冲突导致了我们的异常。3. 解决方案与实现3.1 方案一使用TableField排除生成列最直接的解决方案是在实体类的生成列字段上添加TableField注解设置update属性为falseTableField(update false) private BigDecimal totalPrice;这样配置后MyBatis-Plus在生成UPDATE语句时会自动排除该字段。优点配置简单直观不影响其他操作符合MyBatis-Plus的设计哲学缺点需要在每个生成列字段上添加注解如果生成列很多会略显繁琐3.2 方案二自定义全局配置如果项目中有大量生成列可以考虑通过自定义MyBatis-Plus的全局配置来实现Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new BlockAttackInnerInterceptor() { Override public void beforeUpdate(Executor executor, MappedStatement ms, Object parameter) { if (parameter instanceof BaseEntity) { Class? entityClass parameter.getClass(); Field[] fields entityClass.getDeclaredFields(); for (Field field : fields) { if (field.isAnnotationPresent(GeneratedColumn.class)) { TableInfo tableInfo TableInfoHelper.getTableInfo(entityClass); if (tableInfo ! null) { tableInfo.getFieldList().removeIf(f - f.getProperty().equals(field.getName())); } } } } super.beforeUpdate(executor, ms, parameter); } }); return interceptor; } }优点一劳永逸解决所有生成列问题可以自定义注解标记生成列字段缺点实现复杂度较高需要维护自定义逻辑3.3 方案三使用DTO进行更新操作另一种思路是使用专门的DTO对象进行更新操作DTO中只包含允许更新的字段Data public class ProductUpdateDTO { private Long id; private BigDecimal price; private BigDecimal taxRate; // 不包含totalPrice字段 }然后在Service层进行转换public void updateProduct(ProductUpdateDTO dto) { Product product new Product(); BeanUtils.copyProperties(dto, product); productMapper.updateById(product); }优点更新字段完全可控符合领域驱动设计原则缺点需要维护额外的DTO类增加了对象转换的开销4. 深入原理与最佳实践4.1 MyBatis-Plus字段排除机制MyBatis-Plus在构造SQL时主要通过TableInfo类管理字段信息。TableInfo在应用启动时通过反射解析实体类生成其中包含以下关键属性fieldList所有数据库字段映射excludeProperty需要排除的属性名集合logicDeleteField逻辑删除字段TableField(updatefalse)的工作原理就是将字段添加到excludeProperty集合中。4.2 生成列的设计考量在设计包含生成列的表结构时建议明确区分生成列和普通列在数据库文档中标注生成列生成列的命名可以加上前缀如calc_以示区分避免生成列依赖其他生成列多层依赖会增加复杂度4.3 性能优化建议对于频繁更新的表STORED生成列比VIRTUAL生成列性能更好复杂的计算逻辑考虑使用数据库函数而不是生成列生成列不宜过多一般不超过3-5个5. 常见问题排查指南5.1 问题现象速查表现象可能原因解决方案Generated column cannot be updated错误MyBatis-Plus尝试更新生成列使用TableField(updatefalse)生成列值为null生成列计算表达式有误检查DDL语句中的表达式更新操作影响性能生成列依赖的字段被频繁更新考虑使用缓存或调整表结构5.2 调试技巧开启MyBatis-Plus的SQL日志mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl检查TableInfo内容TableInfo tableInfo TableInfoHelper.getTableInfo(Product.class); System.out.println(tableInfo.getFieldList());使用数据库监控工具查看实际执行的SQL5.3 版本兼容性说明MySQL 5.7 支持生成列MyBatis-Plus 3.0 支持TableField的update属性不同数据库对生成列的支持程度不同MySQL/Oracle/PostgreSQL实现有差异6. 扩展思考与进阶方案6.1 动态表字段处理对于需要动态处理字段的场景可以考虑实现自定义的SqlInjectorpublic class CustomSqlInjector extends DefaultSqlInjector { Override public ListAbstractMethod getMethodList(Class? mapperClass, TableInfo tableInfo) { ListAbstractMethod methodList super.getMethodList(mapperClass, tableInfo); // 过滤生成列字段 tableInfo.getFieldList().removeIf(field - field.getProperty().startsWith(calc_)); return methodList; } }6.2 多数据源适配在多数据源环境下不同数据库对生成列的支持不同可以通过DatabaseIdProvider实现差异化配置Bean public DatabaseIdProvider databaseIdProvider() { DatabaseIdProvider provider new VendorDatabaseIdProvider(); Properties properties new Properties(); properties.setProperty(MySQL, mysql); properties.setProperty(Oracle, oracle); provider.setProperties(properties); return provider; }6.3 审计字段的特殊处理生成列常与审计字段如create_time, update_time产生冲突建议审计字段使用数据库触发器维护或者使用MyBatis-Plus的Version、TableLogic等注解避免审计字段与生成列产生交叉依赖在实际项目中我最终采用了方案一TableField注解结合部分方案三关键业务使用DTO的混合策略。对于简单的生成列直接使用注解排除对于复杂业务场景则使用专门的DTO来控制更新字段。这种组合方式既保持了代码的简洁性又确保了关键业务的数据一致性。一个特别容易忽视的细节是即使字段被标记为updatefalse它仍然会被包含在INSERT语句中。对于不允许插入的生成列还需要额外添加insertfalse属性TableField(insert false, update false) private BigDecimal totalPrice;最后提醒任何数据库结构变更后特别是生成列相关的修改一定要重新检查实体类配置确保ORM层与数据库保持同步。