MyBatis 通过嵌套查询与 collection 标签在应用层模拟递归,主查询获取顶层节点后自动调用子查询组装树结构,兼容所有数据库;需实体类含自引用集合、resultMap 中配置 collection 关联子查询,并注意层级深度与性能边界。

MyBatis 本身不直接支持 SQL 层的递归语法(比如 MySQL 8.0+ 的 WITH RECURSIVE),但它通过 嵌套查询 + collection 标签自动递归 的方式,在应用层模拟出“递归效果”——本质是多次 SQL 查询,由 MyBatis 按需触发、逐层组装树结构。这种方式兼容所有数据库(包括不支持 CTE 的 MySQL 5.7、Oracle 11g 等),且逻辑清晰、易于调试。
用 collection 实现自动递归的核心机制
- 主查询只查顶层节点(如
level = 1或parent_id IS NULL) - 每个节点命中后,MyBatis 自动调用
select属性指定的子查询方法,把当前节点的id作为参数传给column="id" - 子查询返回它的直接子节点;对每个子节点,再重复该过程
- 终止条件明确:子查询返回空结果集时,递归停止
✅ 不需要写循环代码,不手动拼树,MyBatis 在内存中自动完成层级嵌套。
关键配置要点
-
实体类必须包含自引用集合字段
public class AreaInfo { private String areaNo; private String areaName; private String parentAreaNo; // ? 必须有这个字段,类型是自身类的 List private List<areainfo> children; }</areainfo> -
resultMap 中用 collection 关联子查询
<resultmap id="areaInfoResult" type="com.example.AreaInfo"><id column="AREA_NO" property="areaNo"></id><result column="AREA_NAME" property="areaName"></result><result column="PARENT_AREA_NO" property="parentAreaNo"></result><!-- 关键:把当前行的 AREA_NO 传给 getAreaInfoTree 的 #{parentAreaNo} --><collection property="children" oftype="com.example.AreaInfo" column="AREA_NO" select="getAreaInfoTree"></collection></resultmap> -
主查询和子查询共用同一个 resultMap
javascript-typescript-typescript-scaffold下载你是 TypeScript 项目架构专家,专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链(pnpm、Vite、Next.js)、类型
<select id="getAreaInfoTree" resultmap="areaInfoResult" parametertype="string"> SELECT AREA_NO, AREA_NAME, PARENT_AREA_NO FROM AREA_INFO WHERE PARENT_AREA_NO = #{parentAreaNo} AND STATUS = '1' </select>注意:
getAreaInfoTree方法既用于顶层调用(如传null或'0'),也用于每层递归调用 —— MyBatis 会自动复用它。
多参数传递(比如带用户 ID、状态等过滤条件)
若子查询还需其他参数(如 create_user, plan_id, state),可用 column="{id=AREA_NO, userId=CREATE_USER}" 语法:
<collection property="children" oftype="Student" column="{id=id, planId=plan_id}" select="selectOtherList"></collection>
对应子查询接收多个参数:
<select id="selectOtherList" resultmap="studentTreeResultMap" parametertype="map">
SELECT id, last_id, name, level
FROM a_student
WHERE last_id = #{id}
AND plan_id = #{planId}
AND state = 'A'
</select>
性能与适用边界提醒
- ✅ 适合层级浅(≤6 层)、总节点数适中(几百~几千)的场景(如菜单、组织架构、区域划分)
- ⚠️ 不适合超深或超宽树(例如百万级节点的无限分类),易引发 N+1 查询放大、堆内存压力大
- ? 替代方案可考虑:
- 数据库原生 CTE(MySQL 8.0+/PostgreSQL/SQL Server)一次性查出扁平数据,Java 层组装树
- 预计算路径字段(如
dep_path = '0/1/5/23'),用LIKE '0/1/%'查询整棵子树 - 前端懒加载:只查一级,点击展开时再查下一层
不复杂但容易忽略










