必须以管理员权限运行命令提示符或powershell，否则netstat -ano不显示pid；先执行netstat -ano | findstr :端口号获取pid，再用tasklist | findstr "pid"查进程名。
Windows 下用 netstat + tasklist 定位占用端口的进程
必须以管理员权限运行命令提示符或 PowerShell，否则 netstat -ano 不显示 PID，查不到真正占用者。
执行两步命令：
-
netstat -ano | findstr :8000（把8000换成你实际报错的端口，比如:80、:443）→ 输出最后一列数字就是 PID -
tasklist | findstr "12345"（把12345换成上一步查到的 PID）→ 看进程名和映像名称
常见结果含义：
- 输出含
frankenphp.exe或php.exe→ 旧实例残留，可安全终止 - 输出为
System且 PID =4→ HTTP.sys 驱动在占:80/:443，绝对不要taskkill /f /pid 4 - 输出是
Skype.exe、nginx.exe、com.docker.backend.exe、MicrosoftEdgeUpdate.exe→ 关掉对应软件即可 - 输出是
svchost.exe→ 需进services.msc查具体服务名（如W3SVC、SQL Server Reporting Services）
macOS 上用 lsof 直接查端口绑定进程
lsof 是 macOS 查端口最准的工具，它原生支持 PID 和命令名输出，不用拼接命令。
推荐命令：
-
lsof -P -n -i :8000→ 快速查看谁在监听该端口（-P跳过端口名解析，-n跳过 DNS 反查） - 若无输出但 FrankenPHP 仍启动失败，补查 TCP LISTEN 状态：
sudo lsof -iTCP -sTCP:LISTEN | grep :8000→ 捕获 ControlCenter、AirPlay 等系统服务
重点看两列：
-
PID：进程编号，后续kill -15 [PID]用得上 -
COMMAND：若为frankenphp，大概率是上次没退出干净；若为kernel_task，说明是系统级服务，别硬杀
Linux / WSL 中优先用 ss 替代 netstat
netstat 在现代 Linux 发行版中已被弃用。ss 更快、更简洁，且默认支持 PID 显示（需 root 权限）。
常用组合：
-
sudo ss -tuln | grep ':8000'→ 查所有监听该端口的 TCP/UDP 连接 -
sudo ss -tulpn | grep ':8000'→ 追加-p显示进程名和 PID（注意：某些发行版需安装iproute2）
注意：-t（TCP）和 -u（UDP）要分开看。FrankenPHP 只用 TCP，但 UDP 占用有时会干扰内核 socket 分配逻辑，尤其在 WSL2 或 systemd-networkd 环境下。
别忘了 Unix socket 文件残留这个“隐形杀手”
FrankenPHP 在 WSL 或 Linux 下默认使用 Unix socket（如 /tmp/frankenphp.sock）通信。异常退出后该文件不会自动删除，新实例尝试 bind 时会报 address already in use —— 错误信息和端口冲突一模一样，但根本不是端口问题。
检查方式很简单：
- 运行
ls -l /tmp/frankenphp.sock，如果存在，直接删：rm /tmp/frankenphp.sock - 再启动 FrankenPHP，错误通常立刻消失
- Symfony 项目里还可能残留
bin/console messenger:consume子进程，它们也用 PHP 启动，lsof或ps查COMMAND列看不出区别，得靠Path或完整命令行确认
端口查不到占用者却启动失败，先看 socket 文件是否存在——这是最容易被跳过的一步。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
