PHP中如何定位触发内存超限致命错误的实际执行CLI脚本？

你遇到的追踪失效问题核心是内存溢出时的资源不足限制：

• 致命内存溢出错误触发时，剩余可用内存已经不足以支撑debug_backtrace()完成全栈遍历，该函数本身需要申请内存存储栈信息，执行到中途就会再次触发内存限制中断，因此只能拿到栈顶的几个框架层文件，无法追溯到最外层入口。
• 默认无参数调用的debug_backtrace()会携带每一层的调用参数，进一步加剧了内存消耗，加快了中断发生。

1. 优化自定义错误日志工具（永久生效方案） #

调整你的错误捕获逻辑，优先保证入口脚本信息能被记录：

• 在框架最开头预留一小块内存，避免错误捕获时无内存可用：

// 框架入口第一行加入，预留1M内存供错误处理使用
$GLOBALS['reserve_memory'] = str_repeat(' ', 1024 * 1024);

• 使用register_shutdown_function注册的 shutdown 回调中，优先释放预留内存、获取入口脚本信息，再收集栈信息：

register_shutdown_function(function() {
    // 先释放预留内存，获得操作空间
    unset($GLOBALS['reserve_memory']);
    $error = error_get_last();
    if (!$error || $error['type'] !== E_ERROR) return;

    // 第一步：先记录入口脚本，几乎无内存消耗
    $entry_script = $_SERVER['SCRIPT_FILENAME'] ?? get_included_files()[0] ?? 'unknown';
    // 直接写入日志，不要等后续操作
    file_put_contents('your_error_log.log', "入口脚本：{$entry_script}\n", FILE_APPEND);

    // 第二步：再收集栈，加参数大幅降低内存消耗
    $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 30); // 忽略参数，最多取30层栈
    // 后续写入栈日志的逻辑...
});

• 其中get_included_files()返回的第一个元素必然是CLI模式下被直接执行的入口脚本，不需要依赖完整栈就能拿到。

2. 临时快速定位方案 #

如果不想改动代码，可以直接通过启动侧日志匹配定位：

• 给所有CLI脚本的启动命令加上执行日志，例如在crontab任务、shell启动脚本中，每行PHP命令前加入日志输出：

echo "$(date '+%Y-%m-%d %H:%M:%S') 执行脚本：/path/to/your/script.php" >> /var/log/php_cli_run.log

• 后续匹配错误日志的发生时间，就能直接对应到触发错误的入口脚本。

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