PHP 线上报 Allowed memory size exhausted 怎么定位：内存增长、峰值与回收验证

线上 PHP 接口突然返回 Allowed memory size exhausted，通常不是“把 memory_limit 调大”这么简单。先看单次请求的峰值是在读取数据、组装数组，还是渲染响应时出现，再用分段日志确认释放是否真的发生，才能判断该改代码、改批量大小，还是调整运行时配置。

先确认故障影响：是单次峰值还是持续增长

这个报错的影响范围非常典型：小数据量请求运行完全正常，导出、批量同步或者后台报表这类任务，处理到某个数据量级就会突然失败。如果 PHP-FPM 的 worker 同时出现多个内存高峰，表面上只是单个接口报错，实际还可能耗尽剩余可用进程，拉低整台机器的可用内存水位。

先把失败请求的输入数据量级、请求路由和对应 worker 日志匹配上。下面这段极简的记录逻辑可以放在批处理入口和出口，不用只对着错误提示页凭空猜原因：

 $label,
        'batch' => $batch,
        'current' => memory_get_usage(true),
        'peak' => memory_get_peak_usage(true),
    ], JSON_UNESCAPED_UNICODE));
}

memory_point('start', 0);
// 批量读取和转换逻辑
memory_point('after-read', 1);
?>

从时间线找触发点：读取、转换还是响应拼装

把日志打点放在三个关键节点，一般就能快速把问题范围缩小到某一步操作：

根因通常在“同时持有”：批量数组和临时副本叠加

最常见的触发场景，就是一次把所有数据全查出来，再逐行转成新的数组或者对象。这时候原始查询结果、转换后的新结构、最后要输出的响应字符串可能同时在内存里共存。就算这些变量之后会被回收，请求也很可能在回收逻辑触发之前就先撞到内存上限。

先把每次处理的批量大小设为显式可配置的参数，并在每批结束清掉不会再使用的引用：

$batchSize = 500;
$offset = 0;

while (true) {
    $rows = loadRows($offset, $batchSize);
    if ($rows === []) {
        break;
    }

    $payload = transformRows($rows);
    sendChunk($payload);

    unset($payload, $rows);
    memory_point('after-chunk', intdiv($offset, $batchSize) + 1);
    $offset += $batchSize;
}

unset() 只会移除当前变量引用，不能修复仍被闭包、全局容器或静态缓存持有的数据。若释放后当前值下降但峰值继续接近限制，说明单批仍太大；若当前值批批上涨，则要继续查找长期持有者。

修复动作怎么选：先缩小批次，再核对运行时限制

排查的优先顺序是先减少内存里同时驻留的数据量，再去核对配置的边界值。可以在测试环境临时打印：

error_log('memory_limit=' . ini_get('memory_limit'));
error_log('current=' . memory_get_usage(true));
error_log('peak=' . memory_get_peak_usage(true));

• 导出接口：改成游标或分页输出，不要把整个结果集拼成一个大字符串。
• 文件处理：按固定字节数读取，避免 file_get_contents() 一次载入大文件。
• 对象转换：转换一批、发送一批，发送后释放原始行和结果数组。
• 配置调整：只在确认机器余量和 PHP-FPM worker 数量后提高 memory_limit，并记录回退值。

复盘验证：修复后要看三个数字

修复后的成功响应不等于问题消失。至少保留批次号、当前内存和请求峰值三个数字，比较同样输入量下的结果。理想状态是每一批结束后当前值回到相近水平，峰值稳定低于 memory_limit，并且输入量增加时不会出现无界增长。

如果峰值仍随总记录数线性上涨，说明代码仍在跨批次保存数据；如果当前值稳定但峰值过高，说明单批大小或响应拼装仍需下调。这里别急着继续加配置，先让一次请求的内存占用逻辑可解释。

常见问题

memory_get_usage() 和 memory_get_peak_usage() 该看哪个？

排查这类内存超限错误时优先看峰值；判断分批后是否释放，则同时看当前值和峰值。

unset() 后内存数字没有下降，说明没有释放吗？

不一定。PHP 可能保留已申请的内存供当前请求复用。重点看后续批次是否继续上涨，以及峰值是否越过限制。

把 memory_limit 调大能彻底解决吗？

单纯调大内存限制只能把故障边界向后移动。若根因是一次装入全部数据或跨批次持有引用，仍应先改处理方式。

小结

Allowed memory size exhausted 的有效排查路径是“记录峰值、对齐时间线、缩小同时持有的数据、验证分段回收”。把 memory_limit 当成预算线，而不是修复按钮，才能让 PHP 批处理在数据量增长后仍然可控。