FrankenPHP端口被占用需先查PID：管理员运行netstat -ano | findstr :端口，再tasklist | findstr "PID"识别进程；PID=4不可杀，应禁用W3SVC等服务；否则可终止对应进程或改frankenphp.toml中server.address为未占端口，并清理/tmp/frankenphp.sock。
FrankenPHP 启动时报“端口被占用”，基本就是它尝试绑定的地址+端口（如 127.0.0.1:8000 或默认的 :80）已被另一个进程抢先调用 bind()，操作系统拒绝重复分配。这不是 FrankenPHP 的 bug，而是标准网络行为——同一端口不能被两个进程同时监听。
怎么快速查出谁在占 80 或 8000 端口
必须用管理员权限运行命令行，否则看不到系统级进程：
- 查端口：执行
netstat -ano | findstr :8000（把8000换成你实际报错的端口号）；输出最后一列是 PID - 查进程名：执行
tasklist | findstr "1234"（把1234换成上一步的 PID） - 常见结果含义：
→ 显示frankenphp.exe：旧实例没退出，可安全杀
→ 显示System且 PID = 4：HTTP.sys 驱动在占80/443，不能taskkill
→ 显示Skype.exe、com.docker.backend.exe、nginx.exe：用户软件，关掉即可
→ 显示svchost.exe：需进services.msc查对应服务，别直接杀
taskkill /F /PID 1234 能不能随便用
不能。盲目 taskkill 可能导致网络中断、蓝屏或服务瘫痪：
- PID = 4 的
System进程：绝对不要杀，这是 Windows HTTP API 底层驱动 - 显示
httpd.exe或w3svc：说明 IIS 在运行，杀它会干掉整个 Web 服务 - 显示
php.exe但命令行含bin/console messenger:consume：这是 Symfony 残留消费者，该杀 - 显示
php-cgi.exe或php-fpm：传统 PHP-FPM 实例，若你已切到 FrankenPHP，可停
改 frankenphp.toml 监听端口最稳妥
比起反复清理环境，改配置一劳永逸，尤其适合本地多项目并行开发：
立即学习“PHP免费学习笔记（深入）”；
- 打开配置文件（如
frankenphp.toml），找到[server]段 - 把
address = "127.0.0.1:8000"改成空闲端口，例如"127.0.0.1:8080" - 如果启用了 HTTPS，同步改
tls.address = "127.0.0.1:8443" - 命令行启动时也可覆盖：运行
frankenphp serve --addr :8080，无需改文件 - 注意：前端代码里硬写的
http://localhost要同步改成http://localhost:8080，否则请求仍发向旧端口
还有个容易被忽略的 socket 文件残留
FrankenPHP 默认用 Unix domain socket（如 /tmp/frankenphp.sock）与 Caddy 或 Nginx 通信。如果上次异常退出没清理，新实例会因 Address already in use 失败，且这个错误不提示具体路径：
- 检查是否存在：
ls -l /tmp/frankenphp.sock（Linux/macOS）或看 Windows 对应临时目录 - 手动删除：
rm -f /tmp/frankenphp.sock - 这个文件不会自动重建，不删就一直卡住，哪怕端口已空闲
