尧图网站建设 免费方案咨询
ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

首页/资讯中心/资讯详情

MyBatis-Plus更新MySQL生成列的解决方案

发布时间：2026/11/5 4:42:15 尧图网站建设
MyBatis-Plus更新MySQL生成列的解决方案

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字段。其底层实现逻辑是：

  1. 通过反射获取实体类所有字段值
  2. 排除null值字段
  3. 构造包含剩余字段的UPDATE语句

对于常规字段，这种机制没有问题。但对于生成列，即使我们没有显式设置它的值，由于它在Java实体类中有对应字段，MyBatis-Plus仍会将其包含在UPDATE语句中。

2.2 生成列的特殊性

生成列在数据库层面有以下特点：

  1. 值由数据库自动计算，不允许手动更新
  2. 在INSERT语句中可以完全省略
  3. 在UPDATE语句中如果包含会抛出错误

这与MyBatis-Plus的默认行为产生了冲突，导致了我们的异常。

3. 解决方案与实现

3.1 方案一：使用@TableField排除生成列

最直接的解决方案是在实体类的生成列字段上添加@TableField注解，设置update属性为false：

@TableField(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在应用启动时通过反射解析实体类生成，其中包含以下关键属性：

  1. fieldList：所有数据库字段映射
  2. excludeProperty：需要排除的属性名集合
  3. logicDeleteField：逻辑删除字段

@TableField(update=false)的工作原理就是将字段添加到excludeProperty集合中。

4.2 生成列的设计考量

在设计包含生成列的表结构时，建议：

  1. 明确区分生成列和普通列
  2. 在数据库文档中标注生成列
  3. 生成列的命名可以加上前缀如"calc_"以示区分
  4. 避免生成列依赖其他生成列（多层依赖会增加复杂度）

4.3 性能优化建议

  1. 对于频繁更新的表，STORED生成列比VIRTUAL生成列性能更好
  2. 复杂的计算逻辑考虑使用数据库函数而不是生成列
  3. 生成列不宜过多，一般不超过3-5个

5. 常见问题排查指南

5.1 问题现象速查表

现象可能原因解决方案
"Generated column cannot be updated"错误MyBatis-Plus尝试更新生成列使用@TableField(update=false)
生成列值为null生成列计算表达式有误检查DDL语句中的表达式
更新操作影响性能生成列依赖的字段被频繁更新考虑使用缓存或调整表结构

5.2 调试技巧

  1. 开启MyBatis-Plus的SQL日志：
mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  1. 检查TableInfo内容：
TableInfo tableInfo = TableInfoHelper.getTableInfo(Product.class); System.out.println(tableInfo.getFieldList());
  1. 使用数据库监控工具查看实际执行的SQL

5.3 版本兼容性说明

  1. MySQL 5.7+ 支持生成列
  2. MyBatis-Plus 3.0+ 支持@TableField的update属性
  3. 不同数据库对生成列的支持程度不同（MySQL/Oracle/PostgreSQL实现有差异）

6. 扩展思考与进阶方案

6.1 动态表字段处理

对于需要动态处理字段的场景，可以考虑实现自定义的SqlInjector：

public class CustomSqlInjector extends DefaultSqlInjector { @Override public List<AbstractMethod> getMethodList(Class<?> mapperClass, TableInfo tableInfo) { List<AbstractMethod> 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）产生冲突，建议：

  1. 审计字段使用数据库触发器维护
  2. 或者使用MyBatis-Plus的@Version、@TableLogic等注解
  3. 避免审计字段与生成列产生交叉依赖

在实际项目中，我最终采用了方案一（@TableField注解）结合部分方案三（关键业务使用DTO）的混合策略。对于简单的生成列直接使用注解排除，对于复杂业务场景则使用专门的DTO来控制更新字段。这种组合方式既保持了代码的简洁性，又确保了关键业务的数据一致性。

一个特别容易忽视的细节是：即使字段被标记为update=false，它仍然会被包含在INSERT语句中。对于不允许插入的生成列，还需要额外添加insert=false属性：

@TableField(insert = false, update = false) private BigDecimal totalPrice;

最后提醒：任何数据库结构变更后，特别是生成列相关的修改，一定要重新检查实体类配置，确保ORM层与数据库保持同步。

网站建设 视觉设计 SEO优化
返回列表