PHP容器中memory_get_usage()下降但RSS不回落,主因是Zend内存池缓存、扩展绕过Zend MM、cgroup统计延迟;需设ZEND_MM_COMPACT=1、合理配置pm.max_requests与max_children,并显式销毁GD、PDO、SDK等资源。

PHP 8.3 容器化部署中内存不释放,绝大多数情况不是 PHP 自身没回收,而是容器环境掩盖了真实泄漏点——比如常驻进程未重启、扩展资源未销毁、或 memory_limit 配置被覆盖导致脚本在 OOM 前就卡死。
为什么容器里 memory_get_usage() 看着降了但 RSS 不回落
容器内看到 memory_get_usage() 下降,但 ps aux 显示的 RSS(Resident Set Size)居高不下,说明内存没还给操作系统。这通常因为:
- Zend 内存管理器(Zend MM)默认启用内存池缓存,
efree()后内存留在池里供后续emalloc()复用,不归还 OS - PHP 扩展(如
redis、grpc、自研 C 扩展)调用了malloc()而非emalloc(),这部分内存完全绕过 Zend MM,unset()或 GC 都无效 - Docker 默认使用 cgroup v1,对内存统计有延迟;升级到 cgroup v2 +
memory.low配置可改善感知精度 - CLI 模式下未设
ZEND_MM_COMPACT=1,大块内存无法触发池内整理归还
容器启动时必须加的关键环境变量
别只改 php.ini,这些环境变量在容器里才是生效前提:
-
ZEND_MM_COMPACT=1:强制 Zend MM 在每次 GC 后尝试合并空闲块并归还大块内存给 OS(PHP 8.2+ 支持) -
ZEND_MM_DEBUG=1:仅用于调试,开启后能捕获emalloc/efree不配对问题,但会显著拖慢性能,生产禁用 -
PHP_MEMORY_LIMIT=512M:通过环境变量传入比修改php.ini更可靠,Dockerfile 中用ENV PHP_MEMORY_LIMIT=512M,然后在入口脚本里写入php -d memory_limit=$PHP_MEMORY_LIMIT -
OPCACHE_VALIDATE_TIMESTAMPS=0:避免文件监控开销,尤其挂载大量源码时;配合opcache.revalidate_freq=0可减少内存抖动
PHP-FPM 容器必须配 max_requests + pm.max_children
FPM 模式下,单个 worker 进程生命周期越长,静态变量、扩展级缓存、循环引用累积风险越高。不能依赖 GC 自动清理:
立即学习“PHP免费学习笔记(深入)”;
-
pm.max_requests = 500:强制 worker 处理 500 个请求后优雅退出,彻底重置内存状态(注意:值太小会增加进程创建开销) -
pm.max_children必须结合容器--memory限制计算:例如容器限制1G,每个 FPM worker 平均 RSS 为 30MB,则max_children ≤ 32,否则 OOM Killer 会直接杀进程 - 在
www.conf中显式关闭动态调整:pm = static或pm = ondemand,避免pm.start_servers在负载波动时反复 fork 导致内存碎片 - 检查
slowlog是否启用:长时间阻塞(如未超时的 cURL、PDO 查询)会让 worker 卡住不释放,间接推高内存占用
哪些资源在容器里最容易漏掉销毁
容器无 GUI、无交互,很多本地开发时“反正会退出”的侥幸心理,在常驻进程中变成泄漏温床:
-
imagedestroy($img):GD 图像资源不销毁,底层 C 分配的像素内存永不归还,且不受memory_limit管控 -
$pdo->prepare()->execute()后,PDOStatement对象必须显式unset()或赋值为null,否则结果集缓存在 PDO 内部句柄中 - Swoole 场景下,
Swoole\Coroutine\MySQL连接池中的连接对象若被闭包捕获(如go(function () use ($conn) { ... })),即使$conn被unset,协程栈仍强引用它 - 第三方 SDK(如阿里云 OSS、腾讯云 COS)的 Client 实例常含静态缓存或长连接,务必调用其
close()或destroy()方法,不能只靠析构函数
最易被忽略的是:容器里没有 register_shutdown_function() 的可靠执行保障——如果进程被 docker stop 或 OOM Killer 终止,析构函数根本不会运行。所有关键资源释放逻辑,必须放在业务主流程末尾显式执行,而非依赖自动机制。



















