递归函数未设终止条件或判断失效是线上最常见报错原因，表现为“Allowed memory size exhausted”或“Maximum execution time exceeded”，本质是无限递归导致内存耗尽或超时，而非执行缓慢。
递归函数没设终止条件或判断失效
这是线上递归报错最常见原因，表现是 Fatal error: Allowed memory size of xxx bytes exhausted 或 Maximum execution time of xx seconds exceeded。不是代码“慢”，而是根本没停下来。
检查点：
- 终止条件是否写在递归调用前？顺序错会导致跳过判断
- 条件里用的变量是否被递归中意外修改（比如传引用但没 clone）
- 边界值是否覆盖全（如 $n 比 <code>$n == 0 更安全）
- 数组/对象递归时，是否漏判 empty() 或 is_array() 导致空结构继续下钻
递归深度超限却没抛异常
PHP 默认不限制递归层数，但实际受内存和 timeout 约束。靠崩溃再查太被动，应在函数入口主动控深。
实操建议：
- 所有递归函数加 $depth = 0 参数，每次调用传 $depth + 1
- 开头加硬限制： if ($depth > 200) { throw new RuntimeException('Recursion too deep at ' . __FILE__ . ':' . __LINE__); }
- 别用 ini_set('xdebug.max_nesting_level', ...) —— 这只影响 Xdebug，线上通常关着，不生效
- 深度阈值按业务设：树形结构一般 50–100 层足够，JSON 解析建议 ≤ 30
错误日志里看不到递归堆栈
默认 PHP 错误日志只记最后一层崩溃点，比如 Allowed memory size exhausted in /a.php on line 42，但那行只是“压垮骆驼的最后一根稻草”，真问题在第 3 层或第 17 层。
解决方法：
- 在递归函数开头加 error_log("recursion depth: $depth, data key: " . json_encode($key ?? null), 3, '/tmp/php-recursion.log');
- 不要用 var_dump() 或 echo —— 输出可能被缓冲截断，且线上禁用 display_errors
- 日志路径确保 Web 用户（如 www-data）有写权限，否则日志静默丢弃
- 配合 tail -f /tmp/php-recursion.log 实时观察调用链膨胀过程
Xdebug 在生产环境不可用怎么办
绝大多数线上环境禁用 Xdebug（性能损耗+安全隐患），不能依赖断点或堆栈可视化。
立即学习“PHP免费学习笔记（深入）”；
替代方案：
- 用 debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 5) 在关键位置手动采样，记录调用层级和文件行号
- 把结果写进日志，而非输出到页面：error_log(json_encode(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 3)), 3, '/tmp/backtrace.log');
- 注意：不要在每层都调用，选入口、中间转折点、终止前三个位置即可，避免日志爆炸
- 若用 FPM，确认 php_admin_value[error_log] 在 www.conf 里没被覆盖，否则日志写不到你指定的位置
递归的问题从来不在“怎么写”，而在“怎么让它停”。线上环境看不见堆栈、不敢开调试器、日志还容易写失败——真正卡住人的，往往是那个被当作“理所当然”的终止条件，和它背后没校验清楚的数据状态。
