MyBatis-Plus 处理 MySQL 虚拟列的最佳实践

MyBatis-Plus 处理 MySQL 虚拟列的最佳实践

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus

问题背景

在使用 MyBatis-Plus 进行数据库操作时，开发者可能会遇到 MySQL 虚拟列（Generated Column）的处理问题。虚拟列是 MySQL 5.7 及以上版本引入的特性，它的值由表达式计算得出而非直接存储。当使用 MyBatis-Plus 的批量插入方法 InsertBatchSomeColumn 时，系统可能会报错提示不允许为虚拟列指定值。

问题分析

虚拟列在数据库中有两种类型：

1. STORED：值实际存储在表中
2. VIRTUAL：值在查询时动态计算

MyBatis-Plus 默认会尝试为所有字段生成插入语句，包括虚拟列，这就会导致上述错误。虽然可以通过 @TableField(exist = false) 注解来排除字段，但这会导致该字段既不能插入也不能查询，显然不是理想的解决方案。

解决方案

MyBatis-Plus 提供了更优雅的处理方式：

方案一：使用字段策略控制

@TableField(insertStrategy = FieldStrategy.NEVER, updateStrategy = FieldStrategy.NEVER)
private String virtualColumn;

这种配置告诉 MyBatis-Plus：

• 插入时忽略此字段
• 更新时忽略此字段
• 但查询时仍会包含此字段

方案二：自定义批量插入过滤器

如果使用 InsertBatchSomeColumn 进行批量插入，可以通过设置 predicate 来过滤虚拟列：

new InsertBatchSomeColumn(t -> {
    // 在这里添加判断逻辑，排除虚拟列
    return !t.getProperty().equals("virtualColumnName");
})

最佳实践建议

1. 明确标识虚拟列：在实体类中清晰标注哪些是虚拟列，方便团队协作
2. 统一处理策略：项目中虚拟列的处理方式应该保持一致
3. 考虑使用自定义注解：可以创建如 @VirtualColumn 的自定义注解，结合拦截器统一处理
4. 文档记录：在项目文档中记录虚拟列的处理方式，方便后续维护

总结

MyBatis-Plus 虽然目前没有专门针对虚拟列的内置支持，但通过合理利用现有的字段策略控制和批量操作过滤器，完全可以优雅地处理 MySQL 虚拟列。开发者应根据实际项目需求选择最适合的方案，并在团队中形成统一的处理规范。

对于复杂的虚拟列场景，也可以考虑扩展 MyBatis-Plus 的功能，通过自定义 SQL 注入器或拦截器来实现更智能的虚拟列处理逻辑。

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus