必须用精准锚点(如WHERE id = @rootId)启动递归,JOIN方向须为e.parent_id = s.id向下遍历,parent_id字段需有索引,层级/路径等字段须在CTE内计算,终止依赖JOIN失败而非显式条件。

能直接用 WITH RECURSIVE 一次性查出整棵树,不需要应用层循环,但锚点写错、JOIN方向反了、没设索引,结果就为空或极慢——而且不报错,很难察觉。
锚点必须精准定位起点,不能笼统用 parent_id IS NULL
锚点不是“找所有顶层节点”,而是“从某一个具体节点开始展开”。比如查员工ID为105的所有下属,锚点就得是 WHERE id = 105;查分类ID为7的完整子树,锚点就是 WHERE id = 7。
- 误用
WHERE parent_id IS NULL会导致拉出全部根节点,变成查整棵树,而非从某点出发的子树 - 如果起点ID根本不存在(比如传入了错误参数),CTE返回空结果集,不会报错,容易被当成“没数据”忽略
- 锚点字段(如
id或name)必须有索引,否则第一轮扫描就全表,后续递归再快也白搭
向下查子节点时,JOIN 条件必须是 e.parent_id = s.id
这是最常踩的坑:方向写反,结果就为空,且无任何提示。数据库只是没匹配到行,不是语法错误。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 向下遍历(查下属、子分类):递归部分写
FROM employees e INNER JOIN cte_name s ON e.manager_id = s.id - 向上遍历(查父级、面包屑):则要写
FROM employees e INNER JOIN cte_name s ON e.id = s.manager_id - 必须用
INNER JOIN,LEFT JOIN会引入NULL行,破坏层级逻辑,甚至导致无限递归 - 递归成员里不能出现
COUNT()、ROW_NUMBER()等聚合或窗口函数,MySQL 8.0 不支持
层级和路径必须在CTE内部计算,不能留到外层
深度、路径拼接、编号这些业务必需字段,必须在递归定义中生成。外层 SELECT 只能取,不能算。
- 层级
level:锚点设为1,递归部分写s.level + 1 - 路径拼接:锚点用
CAST(name AS CHAR(200)) AS path初始化类型,递归部分用CONCAT(s.path, ' > ', e.name) - 多级编号(如
1.2.4):锚点用CAST(id AS CHAR(50)) AS code,递归部分用CONCAT(s.code, '.', e.id) - 所有计算字段类型要提前明确,尤其
CONCAT后可能截断,CAST长度不够会静默丢字
终止靠 JOIN 失败和 WHERE 过滤,不是显式控制
MySQL 没有 STOP WHEN 或 MAX LEVEL 语法,递归终止完全依赖两个隐式条件。
- 当某轮递归产生的
s.id在原表中找不到匹配的e.parent_id时,JOIN返回空,递归自然停止 - 若你在递归部分加了
WHERE e.status = 'active',那遇到第一个非活跃节点,它和它整个子树都会被跳过 - 默认最大递归深度是
1000,超深组织架构(如3000层)要提前执行SET SESSION max_recursion_depth = 3000 - 没有索引的
parent_id字段会让每轮JOIN都变全表扫描,深度每+1,性能呈指数恶化
真正难的不是写对语法,而是想清楚:你要的是从哪来、往哪走、停在哪、带什么信息回来——这四点定错一个,结果就不可用。而数据库不会提醒你逻辑错了,只会安静地返回空或错乱数据。

















