FrankenPHP启动后端口仍被占用，90%是自身残留进程未退出：macOS/Linux用lsof -i :8000、Windows用netstat -ano | findstr :8000可查出frankenphp或含php-server的php进程；Symfony场景下messenger:consume等长驻进程亦会劫持socket，需ps或tasklist定位并kill，同时清理/tmp/frankenphp.sock。
FrankenPHP 启动后端口又被占，其实是它自己没退干净
FrankenPHP 进程退出后端口仍被占用，90% 是它自己残留——不是别人抢了，而是你关终端、Ctrl+C 中断或 IDE 关闭时，进程没真正退出，还在后台静默监听。macOS/Linux 下用 lsof -i :8000、Windows 下用 netstat -ano | findstr :8000 查到的 COMMAND 或映像名如果是 frankenphp 或 php（且命令行含 php-server），基本就是它自己卡住了。
Windows 上 PID=4 占着 80/443 不是 FrankenPHP 的锅，但会伪装成“它又占了”
当你改了端口（比如用 --addr :8080）还是报错，却查到 PID=4 占着 80 或 443，那不是 FrankenPHP 自动回切端口，而是系统服务（W3SVC、Web Deployment Agent 等）在后台偷偷绑定 HTTP.sys，导致 FrankenPHP 启动时误判端口不可用而失败——它根本没机会监听，就直接崩了。这种情况下你看到的“退出后又占”，其实是每次启动都失败，旧实例早没了，新实例压根没起来。
- 必须进
services.msc手动停掉World Wide Web Publishing Service等服务，不能只靠taskkill - 禁用后重启命令行再试，否则
frankenphp php-server --addr :8080仍会因系统级冲突拒绝启动
Symfony 场景下 messenger:consume 等进程会“假装退出”，实则劫持 socket
如果你用 Symfony + FrankenPHP，php bin/console messenger:consume 这类长任务常设 ignore_user_abort(true)，Ctrl+C 只中断前台 shell，进程本身仍在后台跑，并可能复用 FrankenPHP 的 Unix socket 路径（如 /tmp/frankenphp.sock）或共享同一端口范围。下次启动 FrankenPHP 时，它尝试 bind 同一地址，就报“address already in use”。
- 查残留：Linux/macOS 用
ps aux | grep "messenger:consume\|php-server"；Windows 用tasklist | findstr "php.exe" - 清 socket 文件：
rm -f /tmp/frankenphp.sock（Linux/macOS）或手动删 Windows 下对应路径的.sock文件 - 启动前加检查：
lsof -i :8000 2>/dev/null || frankenphp php-server --document-root public
改端口不是临时补丁，而是防止复发的必要配置
靠每次 taskkill 清 PID 是治标。FrankenPHP 的默认端口（127.0.0.1:8000）太常见，Skype、Docker Desktop、甚至 Edge 更新进程都爱抢。真要稳定，得在配置里固化一个冷门端口，比如 :8088 或 :9222，并确保所有调用点（curl 测试、反向代理、CI 脚本）同步更新。
立即学习“PHP免费学习笔记（深入）”；
- 改
frankenphp.toml中的address = "127.0.0.1:8088"，别只改命令行参数 - 如果用了 HTTPS，
tls.address也得同步改，否则 TLS 握手会失败 - Docker 用户注意：
-p 8088:8088映射要和配置一致，别写成-p 8088:8000
最麻烦的不是找不到谁在占，而是你以为杀掉了，其实它藏在 supervisord 里、systemd 里、或者 PHP 的 pcntl_fork() 子进程里——查端口得看 LISTENING 状态，杀进程得顺藤摸瓜到 root 进程，否则几分钟后它又回来了。
