直接用 lsof -p -n -i :8000（将8000替换为实际端口）查占用进程，重点关注pid和command列；若无输出，改用 sudo lsof -itcp -stcp:listen | grep :端口 精准定位tcp监听者。
FrankenPHP 启动报 bind: address already in use 怎么查
直接用 lsof -P -n -i :8000（把 8000 换成你实际用的端口，比如 8080）——这是 macOS/Linux 下最准、最快的方式。FrankenPHP 启动失败时，90% 是因为端口被占，而 lsof 能直接告诉你谁在用，不绕弯、不依赖 DNS 解析。
输出里重点关注两列：PID 和 COMMAND。如果 COMMAND 是 frankenphp、php、php-fpm 或 messenger:consume，基本就是残留进程；如果是 nginx 或 node，说明其他服务抢了端口。
常见错误现象：
- 执行
lsof -i :8080没输出，但 FrankenPHP 还是起不来 -
COMMAND显示kernel_task或为空，PID 看不到 - 杀掉一个进程后，端口过几秒又“自动”被占
为什么 lsof -i :8080 没结果但端口还是被占
端口可能被 UDP 占了同号端口，或进程用了 SO_REUSEPORT，或监听在 [::]:8080（IPv6）而非 0.0.0.0:8080（IPv4）。这时得加限定条件，强制只看 TCP LISTEN 状态：
运行：sudo lsof -iTCP -sTCP:LISTEN | grep :8080
这个命令能过滤出真正“在监听”的 TCP 进程，比裸 lsof -i 更可靠。注意必须加 sudo，否则看不到其他用户或系统级进程（比如 launchd 在 macOS 上托管的 AirPlay 接收服务有时会悄悄占 :8000）。
使用场景：
- FrankenPHP 配了
--host 0.0.0.0但启动失败 - 换端口重试后仍报错，怀疑有隐藏监听者
- 在 CI/CD 流水线里做端口预检，需要稳定输出
查到 PID 后怎么安全清理
别一上来就 kill -9。FrankenPHP 或 Symfony worker 类进程（如 messenger:consume）常带信号处理逻辑，用 kill -15（SIGTERM）能让它优雅退出、释放 socket 文件和端口。
操作步骤：
- 拿到
PID后，先确认进程还在：ps -p <pid></pid> - 发终止信号：
kill -15 <pid></pid> - 等 2–3 秒，再查一次
lsof -i :8080，确认无输出 - 如果还有残留，再考虑
kill -9 <pid></pid>
特别注意：/tmp/frankenphp.sock 文件可能没被删干净，下次启动还会因 socket 冲突失败。查一下：ls -l /tmp/frankenphp.sock，存在就手动 rm /tmp/frankenphp.sock。
Docker 环境下 lsof 查不到占用进程怎么办
容器内跑的 FrankenPHP 和宿主机是隔离的，lsof 只能查宿主机端口。如果你用 docker run -p 8080:8080 启动，那冲突一定发生在宿主机的 8080 端口上——此时 lsof 依然有效，但目标是宿主机，不是容器。
容易踩的坑：
- 在容器里执行
lsof -i :8080：查的是容器内部，意义不大 - 宿主机上查
lsof -i :8080没结果，但 Docker 报Bind for 0.0.0.0:8080 failed：说明端口被 Docker 自己或另一个容器占了，试试docker ps看有没有重复映射的容器 - 用
docker-compose启动后端口冲突，要记得docker-compose down才能彻底释放端口，Ctrl+C不够
复杂点在于：FrankenPHP 的端口冲突往往不是单一层级的问题。它可能同时涉及宿主机端口、容器网络命名空间、Symfony worker 的 socket 复用、甚至 macOS 的 launchd 服务。查的时候得一层层剥，别指望一个命令扫清全部。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
