FrankenPHP启动报“Address already in use”是端口被占用，非程序自身故障；需用lsof或netstat查PID，确认进程类型后kill残留进程或改server.address为可用端口。
FrankenPHP 启动报 Address already in use，不是 FrankenPHP 本身坏了，而是它要监听的端口（默认 8000 或你配置的 http://:8080）正被别的进程占着——和 Laravel 的 php artisan serve、Workerman、ZMQ 服务撞上的本质完全一样。
查谁在用这个端口（Linux/macOS/WSL）
别猜，直接看：
-
lsof -i :8000（把8000换成你实际配的端口，比如8080）→ 输出里有PID和命令名，一眼就能认出是frankenphp自己的旧进程、php、node还是nginx - 如果
lsof找不到，可能是没装：apt install lsof（Debian/Ubuntu）或apk add lsof（Alpine） - 备选命令：
netstat -tulnp | grep :8000（需要sudo才能显示 PID）
查谁在用这个端口（Windows）
打开 CMD 或 PowerShell，三步走：
-
netstat -ano | findstr :8000→ 最后一列是PID -
tasklist | findstr "12345"（把12345换成上一步查到的 PID）→ 看进程名是不是php.exe或frankenphp.exe - 确认是用户进程（非
svchost.exe、System等），再执行：taskkill /F /PID 12345
为什么 kill 了还报占用？FrankenPHP 的残留进程特别难清
FrankenPHP 默认以多进程模式运行（类似 Workerman），主进程 fork 出 worker，异常退出时容易留下“僵尸 worker”继续 bind 端口。常见表现：
立即学习“PHP免费学习笔记（深入）”；
- 你以为关掉了终端，但后台其实还有
php进程在跑 - 用
Ctrl+C终止时，只杀了主进程，worker 还活着 - 用
ps aux | grep franken（Linux/macOS）或tasklist | findstr php（Windows）搜一下，常能发现多个残留 - 最稳妥清理法（仅开发环境）：
pkill -f frankenphp或killall -u $(whoami) php
启动前加端口检查和自动释放（防复发）
FrankenPHP 没内置端口抢占逻辑，得自己兜底。可以在启动脚本里加一层检查：
#!/bin/bash PORT=8000 if lsof -i :$PORT >/dev/null; then echo "Port $PORT occupied, killing..." lsof -ti:$PORT | xargs kill -9 2>/dev/null fi ./frankenphp server --env dev --host :$PORT
注意：lsof -ti 直接输出 PID，配合 xargs kill -9 一行干掉；生产环境慎用 kill -9，优先用 kill（不带 -9）给进程优雅退出机会。
真正容易被忽略的是：FrankenPHP 的 --host 配置可能写死了 127.0.0.1:8000，但你本地 hosts 或防火墙规则导致它实际 bind 到 0.0.0.0:8000，而 lsof -i :8000 只查 IPv4，漏掉 :::8000（IPv6）。查端口时最好补一句：lsof -i :8000 -i6 :8000。
