opcache内存池爆满导致oom_count>0，主因是opcache.memory_consumption、max_accelerated_files、revalidate_freq配置不当；需调优三参数并验证oom_count归零及used_memory稳定在60%～85%。
OPcache 内存池爆满导致 oom_count > 0
FrankenPHP 自身不管理 OPcache 缓存目录，但 OPcache 的内存池如果配置过小或文件数超限，会频繁触发 oom_count 上升，表现为请求变慢、502、甚至 worker 进程被 OOM Killer 杀掉——这不是磁盘缓存满了，而是共享内存块不够用了。
必须检查并调优三个关键参数：
-
opcache.memory_consumption：单位 MB，不是“越大越好”。Laravel/Symfony 类项目建议设为384～512；低于128容易在加载 vendor 后直接 OOM -
opcache.max_accelerated_files：必须 ≥ 项目实际 PHP 文件总数（含 Composer autoload 的类）。用find ./vendor -name "*.php" | wc -l粗略估算，再加 20% 余量；设太小会导致新文件无法进缓存，反复编译 -
opcache.revalidate_freq：生产环境别设为0，否则每次请求都stat()所有已缓存文件，IO 暴涨且失去缓存意义；设为60或180更稳妥
验证是否生效：运行 php -r "print_r(opcache_get_status()['opcache_statistics']);"，重点关注 oom_count 是否为 0、used_memory 占比是否稳定在 60%～85% 区间。
upload_tmp_dir 未隔离导致/tmp 被写爆
FrankenPHP 默认把上传临时文件写到系统 /tmp，但这个路径通常没有配额限制，多个大文件上传或并发请求可能把整个 /tmp 填满，进而影响其他服务（如 MySQL 临时表、systemd 日志）。
不能依赖默认值，必须显式隔离：
- 创建专用目录：
sudo mkdir -p /var/tmp/frankenphp-upload - 赋权：
sudo chown www-data:www-data /var/tmp/frankenphp-upload && sudo chmod 755 /var/tmp/frankenphp-upload - 在
php.ini中设置：upload_tmp_dir = "/var/tmp/frankenphp-upload" - 容器部署时，确保该路径挂载且非只读，例如
volumes: - "/host/tmp:/var/tmp/frankenphp-upload:rw"
验证方式：php -r "echo ini_get('upload_tmp_dir');" + sudo -u www-data touch /var/tmp/frankenphp-upload/test。若失败，$_FILES 会静默为空，无错误提示。
应用层缓存目录（如 Laravel storage）没设硬性配额
FrankenPHP 不干涉框架的文件缓存逻辑，但像 Laravel 的 storage/framework/cache、storage/framework/views 这些目录，若长期不清理或缓存策略失控（如全量序列化大对象），可能在几周内积累 GB 级文件，最终填满磁盘。
不能靠“定期手动删”，得从机制上约束：
- 用
cache:prune命令配合 cron（Laravel）或自定义脚本，每日清理过期项；注意它不删views，需额外处理 - 对高写入缓存（如计数器、会话），改用 Redis/Memcached，避免文件系统瓶颈
- 若必须用文件缓存，可在
config/cache.php中为 file driver 设置'lock_path' => '/var/tmp/frankenphp-cache-lock'并确保该路径可写，防止并发写冲突导致残留垃圾 - 监控目录大小：
du -sh storage/framework/cache，告警阈值建议设为磁盘总容量的 15%
max_memory_upload 设得过大引发并发内存雪崩
这是 FrankenPHP 特有的坑：max_memory_upload 是 SAPI 层参数，控制单个上传文件在内存中缓存的最大尺寸，默认仅约 2MB。但它不是 PHP 配置项，不会出现在 phpinfo() 里，也**不受 memory_limit 约束**。
设得过大（如 512M）看似“更流畅”，实则危险：
- 一个 500MB 文件上传，会直接占满进程 RSS，触发 OOM Killer
- 10 个并发上传，每个 64MB，就吃掉 640MB 内存，远超容器
mem_limit - 该值必须略高于业务允许的最大单文件尺寸（如视频上传上限 20MB → 设
32M），留出 multipart 边界和元数据空间 - 启动时指定：
frankenphp run --max-memory-upload=32M；Caddyfile 中写：max_memory_upload 32M
记住：它不是“缓冲区越大越稳”，而是“刚好够用+留余量”，否则缓存没上限，内存就真没上限了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
