`到底该怎么用？)
MyBatis-Plus实体类映射避坑指南：@TableField(exist=false)到底该怎么用？
在Java企业级开发中，ORM框架的使用已经成为标配。MyBatis-Plus作为MyBatis的增强工具，凭借其简洁的API和强大的功能，赢得了广大开发者的青睐。然而，在实际开发过程中，实体类与数据库表的映射关系常常成为困扰开发者的难题。特别是当实体类中存在一些业务属性，而这些属性并不对应数据库表中的字段时，如果不做特殊处理，MyBatis-Plus在构建SQL时就会报错。本文将深入探讨@TableField(exist=false)的使用场景、注意事项以及相关技巧，帮助开发者避免常见的映射陷阱。
1. 理解实体类与数据库表的映射关系
在MyBatis-Plus中，实体类与数据库表的映射主要通过两种方式实现：
默认映射规则：采用驼峰命名法自动转换
MyUserTable→my_user_tableTEMyUserTable→t_e_my_user_table
注解显式声明：使用
@TableName注解指定表名
@TableName("sys_user") public class User { // 类属性... }当实体类属性与数据库字段命名不一致时，可以使用@TableField注解进行显式映射：
@TableField(value = "user_name") private String username;2.@TableField(exist=false)的核心应用场景
在实际业务开发中，我们经常会遇到实体类需要包含一些业务属性，但这些属性并不需要持久化到数据库的情况。常见场景包括：
- 计算字段：基于数据库字段计算得出的值
- 临时属性：仅在业务逻辑处理过程中使用的中间变量
- 关联对象：需要在前端展示但不需要存储的关联数据
- DTO扩展：为特定业务场景扩展的属性
如果不加处理，MyBatis-Plus会尝试将这些属性映射到数据库字段，导致SQL构建失败。这时就需要使用@TableField(exist=false)注解：
public class User { // 数据库映射字段 private Long id; private String username; // 非数据库字段 @TableField(exist = false) private String fullName; // 计算字段 @TableField(exist = false) private List<Role> roles; // 关联对象 }3. 深入理解@TableField注解的其他属性
除了exist属性外，@TableField还提供了多个实用属性，用于精细控制字段映射行为：
| 属性 | 类型 | 说明 | 示例 |
|---|---|---|---|
| value | String | 指定数据库字段名 | @TableField("user_name") |
| exist | boolean | 是否为数据库字段 | @TableField(exist=false) |
| condition | String | 字段在WHERE条件中的预处理 | @TableField(condition="%s LIKE CONCAT('%%',#{%s},'%%')") |
| update | String | 字段在UPDATE时的预处理 | @TableField(update="now()") |
| insertStrategy | FieldStrategy | 插入时的字段策略 | @TableField(insertStrategy=FieldStrategy.NOT_EMPTY) |
| updateStrategy | FieldStrategy | 更新时的字段策略 | @TableField(updateStrategy=FieldStrategy.NOT_NULL) |
FieldStrategy枚举值说明：
IGNORED：忽略判断，无论是否为空都执行操作NOT_NULL：非NULL判断NOT_EMPTY：非空判断（对字符串还会检查是否为空串）DEFAULT：跟随全局配置NEVER：不加入SQL
4.@TableField(exist=false)与transient关键字的区别
很多开发者会混淆@TableField(exist=false)和Java的transient关键字，虽然它们都能让属性不被持久化，但存在本质区别：
| 特性 | @TableField(exist=false) | transient关键字 |
|---|---|---|
| 作用范围 | 仅影响MyBatis-Plus的ORM映射 | 影响Java序列化 |
| 序列化影响 | 不影响 | 阻止字段被序列化 |
| 框架支持 | MyBatis-Plus特有 | Java语言原生特性 |
| 使用场景 | ORM映射控制 | 序列化控制 |
public class Example { @TableField(exist = false) private String ormIgnored; // MyBatis-Plus忽略，但可序列化 private transient String serializationIgnored; // 序列化忽略，但MyBatis-Plus可能尝试映射 }5. 实战中的常见问题与解决方案
5.1 查询结果映射问题
当使用@TableField(exist=false)标注的属性参与查询时，需要注意：
// 错误示例：尝试查询不存在的字段 QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.select("id", "username", "fullName"); // fullName不存在于数据库 // 正确做法：只查询数据库存在的字段 wrapper.select("id", "username");5.2 批量操作时的注意事项
在进行批量插入或更新时，MyBatis-Plus会自动过滤掉exist=false的字段：
List<User> users = ... // 包含非数据库字段 userService.saveBatch(users); // 自动忽略exist=false的字段5.3 与Lombok的配合使用
当使用Lombok的@Data等注解时，确保生成的getter/setter不会影响业务逻辑：
@Data public class User { @TableField(exist = false) private String tempValue; // 可能需要自定义getter/setter来处理特殊逻辑 public String getTempValue() { return this.tempValue != null ? this.tempValue.trim() : null; } }6. 高级应用：动态字段处理
对于更复杂的场景，可以实现MyBatis-Plus的MetaObjectHandler接口来自定义字段处理逻辑：
@Component public class MyMetaObjectHandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { // 插入时自动填充字段 this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now()); } @Override public void updateFill(MetaObject metaObject) { // 更新时自动填充字段 this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); } }7. 性能优化建议
- 避免过度使用
exist=false：大量非数据库字段会增加内存消耗 - 合理使用DTO：对于复杂业务场景，考虑使用专门的DTO而非扩展实体类
- 字段选择查询：使用
select()方法明确指定需要查询的字段 - 延迟加载：对于关联对象，考虑使用延迟加载策略
// 只查询必要字段 userMapper.selectList( Wrappers.<User>query() .select("id", "username") );在实际项目中，我曾遇到一个性能问题：一个实体类中添加了多个exist=false的计算字段，在批量查询万级数据时导致内存溢出。解决方案是将这些计算字段移出实体类，改为在Service层按需计算。
