应优先查看 error.log 而非控制台，因其记录更早绑定尝试、sapi 初始化失败原因及实际监听地址（如 [::1]:8000 或 127.0.0.1:8000），避免误判端口冲突；默认路径依启动方式而定，可加 --log-level debug 获取更多细节。
启动失败时怎么看 error.log 而不是只盯控制台
FrankenPHP 控制台报错往往只有 listen tcp :8000: bind: address already in use 这类泛泛提示，真正关键的上下文在 error.log 里。它会记录更早的绑定尝试、SAPI 初始化失败原因，甚至显示实际监听地址（比如是 [::1]:8000 还是 127.0.0.1:8000），而这两者在某些系统上会被视为不同端口。不查日志就直接杀进程，容易误判。
默认日志路径取决于启动方式：用 frankenphp run 时通常输出到终端；用 frankenphp php-server 时会写入 storage/logs/frankenphp-error.log（Laravel/Symfony 项目）或当前目录的 error.log。加 --log-level debug 可强制输出更多绑定细节。
Windows 下用 netstat + tasklist 快速定位占用进程
管理员权限打开 CMD 或 PowerShell，执行两步命令：
-
netstat -ano | findstr :8000（把8000换成你实际用的端口）→ 输出最后一列是 PID -
tasklist | findstr "1234"（把1234换成上一步的 PID）→ 显示进程名和内存占用
常见干扰项：PID=4 是 Windows 的 System 进程，不能 kill；nginx.exe、php.exe、java.exe 这些可以安全终止；如果看到多个 php.exe，大概率是 Symfony 的 messenger:consume 或旧 frankenphp 实例残留。
macOS 下优先用 lsof 精准查端口归属
终端执行：
-
lsof -P -n -i :8000→ 查 TCP/UDP 监听该端口的进程，重点关注PID和COMMAND列 - 若无输出但启动仍失败，补查：
sudo lsof -iTCP -sTCP:LISTEN | grep :8000→ 排除 UDP 占用或内核级服务（如 AirPlay 接收器）
注意：COMMAND 显示 kernel_task 不代表真有进程在用，可能是系统服务占位；若看到 frankenphp 或 php 且 PID 存在，直接 kill -15 [PID]；kill -9 仅当 -15 无效时才用，避免 socket 文件残留。
改端口前先确认 FrankenPHP 是否真在监听那个地址
很多“端口冲突”其实是配置误解：
- 检查启动命令是否带了
--addr，比如frankenphp php-server --addr :8080，那冲突端口就是8080，不是默认8000 - Caddyfile 中
php指令块若配了listen 127.0.0.1:9000，FrankenPHP 会尝试反向连接这个地址，此时冲突的是9000，不是 HTTP 端口 - 用
frankenphp run --config Caddyfile启动时，Caddyfile 里localhost:8000写成0.0.0.0:8000会导致 IPv6/IPv4 绑定行为差异，某些情况下netstat查不到但实际已占
最稳妥的验证方式：改用临时端口启动，例如 frankenphp php-server --addr :8001，能起来就基本坐实是原端口冲突——但别忘了清理旧 socket 文件，比如 /tmp/frankenphp.sock，否则下次换回 :8000 还可能失败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
