FrankenPHP 启动报“address already in use”需先用lsof -i :8000（Linux/macOS）或netstat -ano | findstr :8000（Windows）定位占用进程PID，再查对应进程名；改端口必须通过启动命令的-addr参数指定，如./frankenphp serve -addr 127.0.0.1:8001，而非修改配置文件。
FrankenPHP 启动失败报 “address already in use” 时，不能只改配置就重启——它默认监听 8000 端口，但这个端口常被其他 PHP 内置服务器、Laravel Sail、Docker 容器或残留 php -S 进程占着，必须先确认冲突源再换端口，否则改完照样起不来。
怎么查清楚是哪个进程占了 FrankenPHP 的默认端口
FrankenPHP 默认监听 8000（启动日志里会写 Listening on http://127.0.0.1:8000），但也支持通过 -addr 参数指定，所以第一步不是改配置，而是验证当前谁在用这个端口：
- Linux/macOS：运行
sudo lsof -i :8000或sudo ss -tulnp | grep ':8000'，看输出末尾的pid/program，比如12345/php或6789/docker-proxy - Windows：以管理员身份运行 CMD，执行
netstat -ano | findstr :8000，记下最后一列 PID，再用tasklist | findstr 12345查进程名 - 特别注意：如果 PID 是 4（Windows）或显示为
systemd/launchd（macOS），大概率是 HTTP.sys、php -S残留或 Docker 的 bridge 网络在占，别直接 kill，先ps aux | grep php或docker ps排查
修改 FrankenPHP 监听端口的两种方式（命令行优先）
FrankenPHP 没有传统意义上的全局配置文件，它的端口由启动命令决定。改端口最直接、最可靠的方式是改启动参数，而不是去翻 YAML 或 JSON 配置（它压根不读那些）：
- 如果你用的是二进制直接启动：
./frankenphp serve -addr 127.0.0.1:8001（把8000换成任意未占用端口） - 如果你用
composer create-project生成的项目，启动脚本通常是composer start，这时要改composer.json里的scripts.start命令，把其中的-addr 127.0.0.1:8000替换掉 - 如果你用 Docker，改
docker run命令里的-p 8000:8000为-p 8001:8001，同时确保容器内 FrankenPHP 启动时也用了-addr :8001（否则容器内还是监听 8000，端口映射会失败）
为什么改了端口还访问不了？三个易漏点
端口改完重启服务，curl http://127.0.0.1:8001 返回 connection refused，问题往往不在 FrankenPHP 本身：
立即学习“PHP免费学习笔记（深入）”；
-
frankenphp serve必须带-addr参数，不加默认就是:8000；光改 Docker-p或反向代理 upstream 不够，容器里进程得真监听那个端口 - 某些 IDE（如 PHPStorm）内置的 PHP Web Server 插件会悄悄占着
8000，即使你没手动开——关掉 IDE 的“Use built-in web server”选项再试 - macOS 上启用
phpbrew或asdf切换 PHP 版本后，php -S可能仍指向旧二进制，残留进程用lsof -iTCP -sTCP:LISTEN -P | grep :8000才能揪出来
FrankenPHP 的端口逻辑非常干净：它不读配置文件、不依赖环境变量、不 fallback 到默认值——-addr 缺失就硬用 :8000。所以排查核心永远是两件事：谁在占，以及你传给 frankenphp serve 的 -addr 值对不对。其他所有“改配置”的思路，都是误入歧途。
