递归函数卡死或内存耗尽的根本原因是终止条件未生效。需检查所有分支是否都有return、参数是否真正变小、返回值是否被正确接收，并通过日志记录调用深度和出口状态来定位问题。
递归函数卡死或报“Allowed memory size exhausted”
这基本等于在喊你：终止条件没生效。PHP 每次调用函数都会压栈，没出口就一直压，直到内存撑爆。别急着调 xdebug.max_nesting_level，先看代码里有没有真正能「拦住」递归的分支。
- 检查所有
if分支是否都带return—— 尤其是空数据、null、false这类边界值，漏一个就断链 - 确认终止判断用的是「可变参数」，比如
if ($depth >= 50)或if (!$parentId)，而不是只依赖empty($children)这种可能被脏数据绕过的逻辑 - 在终止分支开头加
error_log("base case hit: $parentId", 3, '/tmp/recursion.log')，运行后看日志里有没有这条记录
递归调用后返回值丢失或变成 null
不是 PHP 不执行，是你没接住结果。PHP 递归里最隐蔽的坑就是某一层忘了 return，上层拿到 null，再往下 foreach(null) 或 array_merge(null, [...]) 直接崩。
- 每个分支都要有明确返回值：终止分支返回数组/标量，递归分支必须
return子调用结果，兜底分支（比如else）也得给个return []或return false - 别在递归体里用
echo或var_dump代替return—— 它们不返回任何东西 - 如果函数该返回数组，就别让任何路径返回
0、''或null，类型混用会触发 Notice 或静默失败
参数没变小，递归原地打转
常见于处理数组或树结构时传了原数组、没切片、没更新 ID、或查库没缓存 —— 每次递归都在处理同一份数据，永远达不到终止条件。
- 检查递归调用时的参数：比如遍历数组，要用
array_slice($arr, 1)而不是$arr；查子节点，要传新$childId而不是反复用同一个$parentId - 避免每层都查数据库：一次性查全量，建好
$map（键为parent_id），递归时只从$map[$parentId]取子项 - 传参时注意引用陷阱：默认传值更安全；只有真需要改原变量才加
&，且调用和定义两边的&必须严格一致
调试时看不到调用层级和数据流向
光看报错没用，得知道哪一层开始歪了。靠 var_dump 堆屏容易乱，得让输出自带「深度感」。
立即学习“PHP免费学习笔记（深入）”；
- 把
$depth当必传参数，初始传0，每次递归加1，并在入口处打印：error_log(str_repeat('→', $depth) . "call with id=$id", 3, '/tmp/recursion.log') - 出口也记一笔：
error_log(str_repeat('←', $depth) . "return: " . json_encode($result), 3, '/tmp/recursion.log') - 别依赖浏览器输出 —— 缓冲区可能截断，日志文件才能看到完整链条
