frankenphp启动报“bind: address already in use”说明端口被占，需用lsof -p -n -i :8000查pid和command，无输出则sudo lsof -itcp -stcp:listen | grep :8000补查，确认为残留进程后kill -15 pid，再删/tmp/frankenphp.sock。
macOS上FrankenPHP v1.2.0启动报 bind: address already in use，说明它想监听的端口（比如默认 :8000 或你配置的 :8080）已被其他进程抢先绑定，必须用 lsof 精准定位到 PID 和进程名，不能靠猜测或模糊搜索。
第一步：用基础 lsof 查端口归属
打开终端，执行：lsof -P -n -i :8000，把 8000 换成你实际启动时指定的端口号（如 frankenphp serve --addr :8080 就查 :8080）。
这命令跳过 DNS 解析和端口名映射，输出干净直接。重点看两列：PID（进程编号）和 COMMAND（进程名）。如果 COMMAND 是 frankenphp、php 或带 --addr 参数的完整命令，基本就是旧实例没退出——它还在后台安静地占着端口。
若输出为空，别急着认为端口空闲，继续下一步。
第二步：补查 TCP LISTEN 状态，排除系统级干扰
有些监听者不会出现在裸 lsof -i 结果里，比如 macOS 的 AirPlay 接收器、ControlCenter 或 launchd 托管的服务，它们可能以 kernel_task 名义出现，或根本没显示 COMMAND。
这时必须加权限和限定条件：sudo lsof -iTCP -sTCP:LISTEN | grep :8000（同样替换端口号）。
不加 sudo 就看不到 root 或系统级进程；不加 -sTCP:LISTEN 就会混入大量 ESTABLISHED 连接，根本找不到真正在“等请求”的服务。
如果这条命令有输出，且 PID 对应的进程是 frankenphp 或你熟悉的开发工具（如 node、nginx），那就确认了冲突来源。
第三步：确认是不是 FrankenPHP 自己没退干净
方法一：查到 PID 后，立刻验证它是否真是 FrankenPHP 实例：ps -p 1234 -o args=（把 1234 换成你查到的 PID）。
看输出里有没有 frankenphp serve、php-server 或含 --addr 的字符串。有，就是它自己没走；没有，再查别的。
方法二：直接看终端历史。FrankenPHP 常因 Ctrl+Z 挂起、IDE 内嵌终端意外关闭而残留——这种进程不会出现在前台，但 lsof 一定能抓到。
注意：ps aux | grep franken 是陷阱，可能匹配日志文件或注释里的单词，误杀风险高，别用。
第四步：安全清理残留进程并清 socket 文件
① 先发 SIGTERM：执行 kill -15 1234（1234 是上一步确认的 PID），给 FrankenPHP 机会优雅退出、释放端口和临时资源。
② 等 2–3 秒，再跑一次 lsof -P -n -i :8000，确认输出为空。
③ 如果还有残留，再执行 kill -9 1234 强杀——但强杀后必须手动清理 Unix socket：rm -f /tmp/frankenphp.sock。
漏删 /tmp/frankenphp.sock 是重启失败的高频原因，它会导致新实例启动时报 Address already in use，但错误信息里完全不提这个路径。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
