MyBatis‑Plus 实体映射注解 N1 问题完整解决方案一、MyBatis‑Plus 实体与数据库表映射注解MP 基于 MyBatis底层最终还是生成 MyBatis 的 SQL注解写在 Java 实体类上替代 xml 里手写 resultMap。 依赖springbootdependency groupIdcom.baomidou/groupId artifactIdmybatis‑plus‑spring‑boot‑starter/artifactId version3.5.5/version /dependency数据库表t_useriduser_nameagedept_iddelete_flag实体User.javaimport com.baomidou.mybatisplus.annotation.*; import lombok.Data; Data // 指定表名如果实体名和表名一致可以省略不一致必须写 TableName(t_user) public class User { /** * 主键注解 * AUTO数据库自增INPUT手动赋值ASSIGN_ID雪花算法Long主键ASSIGN_UUID字符串UUID */ TableId(type IdType.ASSIGN_ID) private Long id; /** * TableField普通字段映射 * value数据库列名 * exist false该属性不是数据库表字段MP生成SQL时忽略该字段 */ TableField(value user_name) private String userName; private Integer age; TableField(dept_id) private Long deptId; // 逻辑删除字段 TableLogic private Integer deleteFlag; // 非数据库字段业务VO扩展字段MP不要处理该字段 TableField(exist false) private Dept dept; TableField(exist false) private ListOrder orderList; }核心注解清单1.TableName(t_user)指定对应数据库表名支持 schema也可以全局配置表前缀。 yml 全局表前缀不用每个类写 TableNamemybatis‑plus: global‑config: db‑config: table‑prefix: t_2.TableId(type IdType.xxx)IdType说明AUTO数据库自增主键ASSIGN_ID雪花算法Long 类型MP 生成ASSIGN_UUIDUUID 字符串INPUT程序手动设置主键值3.TableField(valuedb_column)实体属性和数据库列名不一致时指定开启 mybatis 的map‑underscore‑to‑camel‑case下划线转驼峰大部分普通字段不需要写TableField。4.TableField(exist false)非常常用VO 里的扩展属性、关联对象、集合不属于数据库列MP 做 CRUD 时忽略此字段不会把它拼到 insert/update/sql。5.TableLogic逻辑删除字段配置后调用removeById()不会物理删除执行 update set delete_flag1。6.Version乐观锁版本号注解。⚠️重要区分MyBatis 原生映射写在 xml resultMapMyBatis‑Plus注解写在实体类只对 MP 自带的 BaseMapper 方法生效自己手写 xml 的 SQL注解不起作用仍然要依赖 mybatis 的下划线驼峰配置或者 resultMap。手写 xml 查询即使实体有TableFieldxml 不会读取这个注解MP 示例 BaseMapperpublic interface UserMapper extends BaseMapperUser { } // 直接调用MP自动生成SQL userMapper.selectById(1L); userMapper.insert(user);二、N1 查询问题MyBatis association /collection 嵌套子查询什么是 N1场景嵌套查询association/collection 的 select 属性1. 第 1 条 SQL查询用户列表查出 N 条用户记录1 次select id,user_name,dept_id from t_user;2. 对每一条用户再执行子查询拿部门信息N 条用户就执行 N 次 SQLselect * from t_dept where id?; --执行N次总 SQL1 N 次就是 N1 问题。数据量越大数据库压力爆炸。产生 N1 的 xml 示例不推荐生产resultMap iduserMap typeUser id columnid propertyid/ association propertydept selectcom.mapper.DeptMapper.selectById columndept_id/ /resultMap select idlistUser resultMapuserMap select id,user_name,dept_id from t_user /select调用listUser()返回 100 条用户 → 执行 101 条 SQL。N1 三种解决方案方案 1联表左连接单 SQL 查询生产首选一次 SQL join 把所有需要的数据查出来通过association / collection映射结果没有额外 SQL。resultMap iduserDeptMap typeUser id columnu_id propertyid/ result columnuser_name propertyuserName/ association propertydept javaTypeDept id columnd_id propertyid/ result columndept_name propertydeptName/ /association /resultMap select idlistUserJoinDept resultMapuserDeptMap select u.id u_id, u.user_name, d.id d_id, d.dept_name from t_user u left join t_dept d on u.dept_id d.id /select缺点一对多 join 会出现 “主表数据行重复”MyBatis 依靠id标签做内部去重。⚠️一对多 left join 会膨胀行数1 个用户 10 条订单join 之后会返回 10 行 userorder 数据MyBatis 通过 id 识别自动封装成 1 个 User 对象orderList 里面放 10 个 Order。 如果不写id标签去重失效返回重复对象。方案 2分步查询 批量查询代替循环 N 次不要每条记录单独查子对象先拿到所有外键 id 集合一次性 in 查询。查询用户列表拿到所有deptId集合select * from t_dept where id in (?,?,?,?)一次性查出所有部门Java 内存组装数据业务代码组装 VO推荐大数据量场景性能可控避免 N 次 DB 交互。 优点SQL 简单不会 join 笛卡尔膨胀缺点需要业务代码组装。伪代码示例//1 查询全部用户 ListUser userList userMapper.selectList(null); //2 获取所有deptId ListLong deptIds userList.stream().map(User::getDeptId).filter(Objects::nonNull).distinct().toList(); //3 一次性批量查询部门 MapLong,Dept deptMap deptMapper.selectBatchIds(deptIds).stream() .collect(Collectors.toMap(Dept::getId, Function.identity())); //4 内存组装 for(User user : userList){ user.setDept(deptMap.get(user.getDeptId())); }方案 3开启懒加载仅缓解不能根治 N1MyBatis 配置开启懒加载只有访问关联对象的时候才执行子查询不访问就不执行 SQL。ymlmybatis: configuration: lazy‑loading‑enabled: true aggressive‑lazy‑loading: false治标不治本一旦代码访问关联属性依然会触发 N 次查询大数据量依然灾难。适合小数据量。N1 选型总结小数据、简单关联left join 单 SQLxml association/collection大数据、一对多join 会造成行数膨胀Java 内存分批查询组装 VO方案 2禁止直接使用嵌套子查询 select 属性直接返回给前端大数据列表。补充对比方案优点缺点适用场景Join 单 SQL一次 DB 交互xml 直接映射一对多会行数膨胀数据量大传输量大中小数据列表内存组装 VOSQL 简单无膨胀可控需要手写业务组装代码大数据列表生产高频嵌套子查询 懒加载xml 简洁存在 N1 风险性能差小数据极少使用关联字段场景高频踩坑MP 注解只对 BaseMapper 生效手写 xmlSQL 不识别TableField。TableField(existfalse)忘记写MP 做 insert/update 会把该字段拼进 SQL报列不存在。一对多 joinresultMap 没有写id标签返回重复主对象。嵌套子查询误以为开启懒加载就没有性能问题。实体中关联对象 Dept、ListOrder数据库没有对应列必须加existfalse。