如何在生产环境的PHP中捕获并记录无限递归错误？

关于xdebug.max_nesting_level在生产环境的安全性 #

xdebug.max_nesting_level是Xdebug扩展的配置项，必须安装Xdebug才能使用，但可以通过关闭Xdebug的其他特性（调试、性能分析、自动跟踪等）将性能影响降到最低，在生产环境中是安全的。

具体配置示例（php.ini或站点.conf文件中）：

; 加载Xdebug扩展，仅启用嵌套级别检查
zend_extension=xdebug.so
xdebug.max_nesting_level=200 ; 根据业务场景调整阈值
xdebug.remote_enable=Off
xdebug.profiler_enable=Off
xdebug.default_enable=Off
xdebug.trace_enable_trigger=Off

这种配置下，Xdebug只会在函数嵌套超过阈值时抛出Nesting too deep致命错误，不会产生额外性能开销——只有触发递归错误时才会执行检查逻辑，而此时脚本原本也会因无限递归耗尽资源终止，反而能让错误被Sentry或服务器日志捕获，便于排查根因。

其他捕获生产环境递归错误的方案 #

如果不想依赖Xdebug扩展，也可以通过以下方式处理：

1. 自定义递归深度计数器 #

在可能发生递归的核心函数中，手动维护递归深度，超过阈值时主动抛出异常。这种方式适合针对性监控特定函数，灵活性高：

function processData($data) {
    static $recursionDepth = 0;
    $recursionDepth++;
    
    if ($recursionDepth > 150) {
        throw new RuntimeException(sprintf("递归深度超过阈值：%d", $recursionDepth));
    }
    
    // 业务逻辑处理
    processData($childData);
    
    $recursionDepth--; // 回溯时递减计数器，避免影响后续调用
}

抛出的异常可被Sentry正常捕获，同时错误信息中会明确递归深度。

2. 调整PHP原生错误日志配置 #

PHP默认存在函数嵌套级别限制（默认值为100），超过后会抛出致命错误，但如果服务器日志或Sentry未捕获到，大概率是错误日志配置问题。可调整php.ini参数确保错误被记录：

error_reporting = E_ALL
log_errors = On
display_errors = Off ; 生产环境禁止前端显示错误
error_log = /var/log/php/fatal_errors.log ; 指定日志存储路径

调整后，递归超过默认阈值时，PHP会将Maximum function nesting level of '100' reached, aborting!的错误写入日志，Sentry也能通过错误日志集成捕获该信息。

3. 自定义错误/异常处理器 #

注册全局错误处理器，在捕获致命错误时收集调用栈信息，补充到错误上报中：

register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && $error['type'] === E_ERROR) {
        // 获取调用栈信息
        $backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
        // 拼接错误信息与调用栈，上报到Sentry
        $errorMessage = sprintf("%s in %s on line %s\n调用栈:\n%s",
            $error['message'],
            $error['file'],
            $error['line'],
            print_r($backtrace, true)
        );
        \Sentry\captureMessage($errorMessage);
    }
});

这种方式能在脚本终止前收集完整调用栈，帮助快速定位递归起点。

内容的提问来源于stack exchange，提问作者bigmacpro