FrankenPHP 1.4 Worker 模式异常排查核心是定位异常请求所属 Worker 进程及其状态、上游依赖链路稳定性，而非单个脚本错误；需通过日志 PID 锚点、进程资源检查、上游超时/连接分析及可控调试接口四步收敛问题。
FrankenPHP 1.4 在 Worker 模式下出现请求处理异常，核心排查逻辑不是“找哪个 PHP 脚本错了”，而是定位异常请求落在了哪个 Worker 进程、该进程当时的状态是否健康、它与上游（如 FastCGI 后端、数据库、外部 API）的交互是否中断或超时。FrankenPHP 的 Worker 模式基于 Swoole 或原生多进程模型（取决于构建方式），每个 Worker 是独立生命周期的长期运行进程，因此异常往往表现为：请求卡住、502/504、响应空白、偶发 segfault、或日志中出现 worker exited unexpectedly。
以下四类关键路径帮你快速收敛问题：
一、确认是哪个 Worker 处理了异常请求
FrankenPHP 默认不记录 Worker PID 到 access log，需手动启用可观测性锚点：
- 在
frankenphp.yaml或 Nginx 配置中，确保log_format包含$pid和唯一标识（如$request_id）：log_format main '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $request_time $upstream_response_time $pid $request_id'; - 启用
request_id：通过map或 FrankenPHP 内置的X-Request-ID响应头回传，确保客户端报错时能提供该 ID - 查到异常请求的
$pid后，立刻用ps aux | grep $pid确认该 Worker 是否仍在运行；若已退出，说明是进程级崩溃
二、检查 Worker 进程自身状态与资源
Worker 异常常由内存泄漏、协程死锁、未释放句柄或信号处理不当引发：
立即学习“PHP免费学习笔记（深入）”；
- 查看 FrankenPHP 主进程日志（通常是
stderr或frankenphp.log），搜索关键词：worker #N died、segmentation fault、out of memory、too many open files - 对疑似异常的 Worker PID 执行：
lsof -p $PID | wc -l（检查文件描述符是否接近 ulimit 上限）cat /proc/$PID/status | grep -E 'VmRSS|Threads'（观察内存占用与线程数是否异常增长） - 若使用 Swoole 底层，可启用
swoole.display_errors=On并检查error_log中是否有coroutine#X is dead或co::sleep timeout
三、验证上游依赖链路是否稳定
Worker 模式下，PHP 代码常直连 MySQL、Redis、gRPC 或调用 exec/fpm-cgi —— 这些操作若阻塞或失败，会拖垮整个 Worker：
- 检查是否启用了同步阻塞调用（如
file_get_contents、mysqli_query无超时、curl_exec无CURLOPT_TIMEOUT）—— 这些在 Worker 中极易造成“一个请求卡死，全队列积压” - 确认数据库连接是否复用且设置了
PDO::ATTR_TIMEOUT或mysqli_options(MYSQLI_OPT_CONNECT_TIMEOUT) - 用
ss -tulnp | grep $PID查看该 Worker 当前建立的 socket 连接，是否存在大量TIME_WAIT或未关闭的ESTABLISHED连接
四、启用调试模式与最小复现
生产环境不宜开 full debug，但可通过可控方式触发诊断：
- 临时加一个 debug 接口（如
/debug/worker-info），返回getmypid()、swoole_cpu_num()、memory_get_usage(true)、当前活跃协程数等，用于横向比对各 Worker 差异 - 用
curl -v "http://localhost:8080/your-route?_worker_id=1"搭配 Nginx 的map $arg_worker_id $upstream_target，强制将请求路由到指定 Worker，便于隔离复现 - 若怀疑是某段代码导致，用
xdebug_start_trace()+xdebug_stop_trace()在入口处包裹逻辑（注意仅限调试环境，避免性能损耗）
