FrankenPHP内存泄漏主因是常驻进程导致静态变量、GD资源等跨请求累积。需手动释放GD图像、DOMDocument、数据库结果集；用WeakMap替代静态缓存；避免闭包捕获大对象。
FrankenPHP 本身不是 PHP 运行时，而是基于 Caddy 的 SAPI 封装层，它复用 PHP 的 Zend 引擎，但以常驻进程（worker）模式运行。这意味着：内存不会像传统 FPM 那样每请求重置，**PHP 层的静态变量、全局缓存、未释放的扩展资源会跨请求累积**——这才是 FrankenPHP 下内存泄漏最典型的成因，而非单纯 memory_limit 不够。
为什么 FrankenPHP 容易出现“内存只增不减”
在 FPM 中，每个请求结束即销毁整个符号表；而 FrankenPHP 的 worker 进程长期存活，以下几类对象/资源若未主动清理，就会持续占住 RSS 内存：
-
static属性（如self::$cache = []）不会自动清空，哪怕请求已结束 - GD 图像资源（
imagecreatefrompng()）未调用imagedestroy()，底层 C 内存永不归还 - PDOStatement 或 MySQLi 结果集未
closeCursor()或free()，尤其配合PDO::FETCH_ASSOC全量加载时 - 闭包中
use了大对象（如use ($hugeArray)），且该闭包被注册为事件回调或存入静态容器 - 第三方扩展（如 Redis、Swoole、protobuf）分配的底层内存未显式释放（例如
$redis->close()或unset($redis)不足以触发 C 层 cleanup）
如何确认是 FrankenPHP 特有的泄漏而非普通 PHP 溢出
关键看错误是否伴随 “Allowed memory size of XXX bytes exhausted”，还是仅观察到 ps aux 中 worker 进程 RSS 持续上涨却无 fatal error。前者是配置或脚本瞬时爆内存，后者才是 FrankenPHP 真实泄漏。
- 用
ps aux --sort=-%mem | head -5观察 worker 进程 RSS 是否随时间线性增长（比如每小时 +20MB） - 在路由 handler 开头和结尾插入：
echo "RSS: " . memory_get_usage(true) . " / peak: " . memory_get_peak_usage(true) . "\n";—— 若两者差值稳定，但ps auxRSS 仍涨，说明泄漏源在 Zend MM 外（如 GD、cURL、扩展） - 临时改用
php-fpm同样逻辑跑 1000 次请求，对比 RSS 是否回落；若回落，则问题锁定在 FrankenPHP 常驻生命周期 - 检查是否启用了
opcache.preload或自定义 preload 脚本——预加载类/函数会永久驻留，且无法unset
必须显式释放的三类资源（FrankenPHP 下尤其关键）
PHP GC 对这三类完全无效，靠 unset() 或自动析构根本不管用，必须手动断链或调用销毁函数：
立即学习“PHP免费学习笔记（深入）”；
-
GD 图像资源：每次
imagecreatefrom*后，必须配对imagedestroy($img)；漏掉一次，对应图像的像素内存就永远卡在进程 RSS 里 -
DOMDocument / XMLReader：创建后调用
$dom->clear()（PHP 8.1+）或$dom->__destruct()（旧版），否则节点树引用锁死内存 -
数据库结果集（非缓冲模式除外）：PDO 中用
$stmt->closeCursor()，MySQLi 中用$result->free()；若使用fetch_all()全量取数据，务必在处理完立刻unset($rows)并gc_collect_cycles()
静态缓存与循环引用的实战修复建议
FrankenPHP 下最隐蔽的泄漏点往往藏在“看起来很安全”的缓存封装里：
- 避免
private static $cache = [];无限追加，改用容量限制 + LRU 清理，例如：if (count(self::$cache) > 1000) array_shift(self::$cache); - 检测循环引用：对疑似对象调用
debug_zval_dump($obj)，若refcount__gc > 1且is_ref__gc === 1，大概率存在双向绑定（如$user->profile和$profile->user） - 用
WeakMap替代普通数组做关联缓存（PHP 8.0+）：$cache = new WeakMap(); $cache[$obj] = $data;—— 当$obj被回收，条目自动消失 - 所有闭包回调（如中间件、事件监听器）注册后，确保在请求结束前解绑，或改用一次性匿名函数，避免
use ($bigData)捕获大变量
FrankenPHP 的内存问题本质是“生命周期错配”：你写的代码按 FPM 模式设计，却跑在常驻进程里。真正要盯紧的从来不是 memory_limit 数值，而是每一个 static、每一次 imagecreate、每一处 use——它们在 FrankenPHP 下都不再“自动善后”。
