“too many consecutive failures”是FrankenPHP主进程因worker子进程连续崩溃（默认5次/60秒）触发的熔断保护信号；需前台运行捕获stderr输出定位PHP Fatal或Segmentation fault，检查vendor/bin/frankenphp-worker.php有效性、PHP启动参数（如opcache.enable、date.timezone）是否显式传入，并强制清理残留进程与缓存。
FrankenPHP 1.4 的 Worker 进程异常退出，不是“PHP 报错就完事了”，而是主进程检测到子 Worker 反复崩溃后主动熔断——报 “too many consecutive failures” 就是明确信号。排查重点不在日志末尾，而在崩溃前的 stderr 输出、worker 启动路径、以及资源残留状态。
看前台 stderr 输出，别只盯 error.log
Worker 崩溃时，错误不会安静写进日志文件，而是直接打在启动终端的 stderr 上（尤其首次运行或前台运行时）。这是最及时、最真实的线索：
- 先停掉所有后台 FrankenPHP：frankenphp stop 或 pkill -f "frankenphp\|worker\.php"
- 前台运行并捕获全部输出：frankenphp run --config ./Caddyfile --debug 2>&1
- 快速触发一次请求（比如 curl http://localhost:8000），观察输出里重复出现的关键词：
• PHP Fatal error（类未找到、扩展缺失、timezone 未设）
• Segmentation fault（xdebug + opcache 冲突、PHP 版本与 FrankenPHP 二进制不匹配）
• Class "App\..." not found in vendor/bin/frankenphp-worker.php（worker 脚本未重生成）
检查 worker 脚本是否有效且可执行
FrankenPHP 1.4 默认用 vendor/bin/frankenphp-worker.php 作为入口。它不是静态文件，而是由 Octane 安装命令生成的“快照”，一旦你改了框架配置、更新了依赖或切换了环境，它就可能失效：
- 确认文件存在且有执行权限：ls -l vendor/bin/frankenphp-worker.php；如无 x 权限，运行 chmod +x vendor/bin/frankenphp-worker.php
- 手动执行它测试：php vendor/bin/frankenphp-worker.php —— 若直接报 Parse error 或 Fatal，说明脚本本身加载失败，不是 Worker 运行时问题
- 如果改过 .env、config/app.php 或升级过 Laravel/Octane，必须重装：php artisan octane:install --server=frankenphp
确认 PHP 启动参数是否真正生效
FrankenPHP 不读系统 php.ini 的全部指令，像 opcache.enable、date.timezone、memory_limit 这些关键项，必须显式传入，否则沿用 CLI 默认值（例如 opcache 默认关闭，timezone 默认 UTC）：
立即学习“PHP免费学习笔记（深入）”；
- 启动时加调试参数验证：frankenphp run --php-flags "-d opcache.enable=1 -d date.timezone=Asia/Shanghai -d memory_limit=512M"
- 若不加 --php-flags 就启动，却在 worker 中遇到 DateTime 构造失败、类加载慢超时等问题，大概率就是这些配置没生效
- 注意：不要依赖 ini_set() —— Worker 长期运行，很多 ini 指令在运行时不可变
排除残留进程和计数器卡死
即使你修好了代码，旧的失败计数器不会自动清零，僵死 worker 也可能还在后台占着资源，导致新启动立刻再报错：
- 强制清空所有相关进程：pkill -f "frankenphp\|worker\.php"，然后 ps aux | grep php 确认输出为空
- 删除 worker 缓存（如有 Octane）：rm -f var/cache/prod/App_KernelProdContainer.php 和 var/cache/dev/App_KernelDevDebugContainer.php
- 清理 Unix socket（Linux/macOS/WSL）：rm -f /tmp/frankenphp.sock
