PHP提示内存耗尽,先查脚本上限
导出报表、导入数据或处理图片时出现下面的错误,说明这次 PHP 执行触碰了脚本内存限制。它并不能证明整台服务器的内存已经用完:
Allowed memory size of 134217728 bytes exhausted (tried to allocate 2097152 bytes)
这里的 134217728 字节是 128 MiB;后面的 2097152 字节是当次尝试申请的 2 MiB,不能据此判断“再加 2 MiB 就够了”。先保存发生时间、任务标识、文件及行号,并检查任务是否已经部分完成,避免重试导入或队列造成重复业务。
先区分是哪一层拦住了内存增长
memory_limit控制 PHP 脚本的内存分配限额,不等于操作系统里这个进程的全部实际占用,也不是整个 FPM 池共用的一份额度。多个并行请求会分别占用内存,容器或系统还可能有独立限制。
若日志写的是 Hard memory limit ... exhausted,应查 PHP 的硬限制。memory_hard_limit_percent从 PHP 8.5.12、8.4.27、8.3.36 和 8.2.35 起提供;这些版本的普通 memory_limit 属于软限制,越界分配可能先完成,再抛出致命错误。硬限制触发则直接结束进程,向标准错误流写消息,退出码也可能是 137。
因此,137 不能单独区分 PHP 硬限制、内核 OOM 或外部强制终止。把 PHP 标准错误、同一时段的内核和容器记录对齐;有系统级证据再按Linux OOM排查继续。本文不通过调整硬限制来掩盖脚本增长。
读取报错任务真正使用的PHP配置
先确认故障来自网页请求、计划任务还是常驻队列。终端里的默认 php 可能与网站不同;以 Ubuntu 上已核实使用 /usr/bin/php8.3 的命令行任务为例:
/usr/bin/php8.3 -v
/usr/bin/php8.3 --ini
/usr/bin/php8.3 -r 'echo PHP_SAPI, " memory_limit=", ini_get("memory_limit"), PHP_EOL;'
这只能证明该 CLI 入口的初始配置,不能代表 FPM 请求,程序运行中也可能再次覆盖。面板或容器部署须换成任务实际使用的可执行文件与环境;网站入口的确定方法见PHP配置生效检查。
网页或队列故障,由维护人员在测试副本的同一执行入口临时加入下列 PHP 语句,放在应用初始化后、耗内存操作前。先确认错误日志有受控的保存位置,仅写入该日志,不新建公开检测页:
error_log(json_encode([
"probe" => "php-memory-check",
"version" => PHP_VERSION,
"sapi" => PHP_SAPI,
"memory_limit" => ini_get("memory_limit"),
"max_memory_limit" => ini_get("max_memory_limit"),
"ini" => php_ini_loaded_file(),
"scanned" => php_ini_scanned_files()
], JSON_UNESCAPED_SLASHES));
根据日志的 sapi、配置路径和实际限额定位配置来源。ini_get()返回 false 表示该指令不存在,不能读成“限额为 0”。PHP 8.5 起还可能由启动配置 max_memory_limit限制可设置的最大值。FPM 的 php_admin_value[memory_limit]也不能被程序里的 ini_set 覆盖;检查这些来源,避免不停往 php.ini 追加同名行。
找出内存在哪一步集中增长
在隔离测试环境选有代表性的小批数据,从现有任务处理流程里分段记录用量,再逐步增加到正常业务规模;不要在正式站故意制造耗尽。下列语句可放在读取、转换和输出等阶段之后,并给各处使用不同阶段名称:
error_log(sprintf(
"memory-stage=after-read usage=%d peak=%d",
memory_get_usage(true),
memory_get_peak_usage(true)
));
两个值都以字节计,反映 PHP 内存管理器的数据,不直接等于进程 RSS。常驻队列的峰值可能包含此前任务;发生致命错误后也不保证还能写出末尾日志,不能用“没看到峰值”排除问题。
- 数据导入或导出:检查是否一次取出全部结果、再复制成多个大数组;优先分页、分批或使用程序支持的流式处理。
- 大图片:检查像素尺寸及同时解码的张数。压缩文件很小,也可能在解码后占用大量内存。
- 重复任务:检查缓存或对象是否跨批次保留,以及新插件、循环或递归是否让用量持续增长。
需要提高限额时,先算并发预算
只有确认任务正常且确实需要更多空间,才在目标站点或任务的实际配置来源调整。修改前保存配置和旧值;共享 FPM 池会影响其他站点,应先确认范围。下面的 256M 仅为写法示例,不是所有服务器的推荐值:
memory_limit = 256M
评估同时运行的 FPM 请求、队列、数据库和系统余量,并考虑容器限额。不要把每个请求的额度都设成整机容量,也不要使用 -1取消限制。FPM 配置检查成功后,才按实际管理方式重载对应服务;常驻队列则按应用正常停机流程更新,避免中途重复消费。
重新读取实际限额,用同一类数据复测,核对任务完成结果、峰值、错误日志及并发下的剩余内存。删去本次临时诊断语句。仍连续增长或只是把失败推迟时,恢复本次参数并继续修正处理方式,不能把“报错晚一点”当成解决。