FrankenPHP重复启动端口被占用本质是旧进程未退出导致bind失败，需先用lsof或netstat确认是否自身残留（如含--addr参数），再精准kill -15终止并清理/tmp/frankenphp.sock，而非盲目改端口。
FrankenPHP 重复启动后端口被占用，本质是旧进程没退出，新实例 bind 失败 —— 不是配置问题，而是系统级资源冲突，必须先清理再启动。
怎么确认是 FrankenPHP 自己没退出干净
很多人以为关掉终端就等于服务停了，其实不是。Ctrl+Z 挂起、IDE 终端意外关闭、或用 nohup 启动后直接退出 shell，都会让 frankenphp 进程继续监听端口。
- 运行
lsof -P -n -i :8000（macOS/Linux）或管理员下netstat -ano | findstr :8000（Windows），看输出里COMMAND或最后一列是否对应frankenphp - 如果 PID 存在，再查完整命令：
ps -p PID -o args=（Linux/macOS）或tasklist /FI "PID eq PID"（Windows），重点看有没有php-server或--addr参数 - 有就是它自己没死透，不是别人抢的 —— 别急着改端口，先杀对进程
如何安全终止残留的 FrankenPHP 进程
别用 pkill php 或全杀 php 进程，会误伤正在跑的其他 PHP 服务（比如 Symfony messenger worker 或 Laravel queue）。
- 精准找：用
ps auxf | grep frankenphp（Linux/macOS）或tasklist | findstr frankenphp（Windows），只锁定名字含frankenphp的进程 - 优雅杀：先发
SIGTERM，给它机会清理 socket 和子进程：kill -15 PID（Linux/macOS）或taskkill /PID PID（Windows） - 强制杀（仅限僵死）：如果
ps显示状态为Z（zombie），或kill -15无响应，再用kill -9 PID或taskkill /F /PID PID - 顺手清 socket 文件：如果用了 Unix domain socket（如
/tmp/frankenphp.sock），运行rm -f /tmp/frankenphp.sock避免 Address already in use 报错
为什么改端口是最稳妥的长期方案
反复查 PID、kill 进程容易漏、也治标不治本。尤其在开发中频繁启停，更推荐固定一个空闲端口并写死配置。
立即学习“PHP免费学习笔记（深入）”；
- 启动时加参数最简单：
frankenphp php-server --addr :8080（注意不是frankenphp serve，后者是旧命令） - 用 TOML 配置文件（
frankenphp.toml）更可靠：[server]<br>address = "127.0.0.1:8080"
如果启用了 TLS，同步改tls.address - Docker 用户注意：
docker run -p 8080:8080要和配置里的address端口一致；若写成-p 8080:80但配置仍是:8000，服务根本不会响应 - 前端代码里硬写的
http://localhost也要同步改成http://localhost:8080，否则请求仍发往 80/8000
真正容易被忽略的是 socket 文件残留和 Windows 下 PID=4 的 System 进程 —— 前者导致 bind 失败却不报具体路径，后者不能 kill 只能禁用 W3SVC 等服务。每次启动前快速扫一眼 lsof 或 netstat，比反复重启省十分钟。
