FrankenPHP在WSL中启动失败提示端口被占用，本质是WSL2端口自动映射至Windows主机，导致Windows上已有进程（如IIS、Skype、旧FrankenPHP实例）抢先绑定同一端口；需在Windows主机以管理员权限执行netstat -ano | findstr :端口定位PID，再用tasklist /FI "PID eq X"确认进程，避免误杀PID=4等系统进程，推荐优先改配置server.address为闲置端口或启用localhostForwarding隔离。
FrankenPHP 在 WSL 中启动失败、提示端口被占用，大概率不是 WSL 内部冲突，而是 Windows 主机上已有进程（比如 IIS、Skype、另一个 FrankenPHP 实例）抢先绑定了目标端口（如 80、443、8000）。
为什么 WSL 的端口会和 Windows 冲突
WSL2 使用虚拟化网络栈，默认通过 NAT 模式与 Windows 主机通信。它的端口并非完全隔离——当 WSL2 中的服务监听 0.0.0.0:8000 时，该端口会自动映射到 Windows 主机的同端口，并受 Windows 系统级 socket 绑定规则约束。这意味着：
- Windows 上任何已绑定
:8000的进程（哪怕只是临时启动的php -S）都会导致 WSL2 中的 FrankenPHPbind: address already in use - WSL1 不走虚拟网卡，端口不自动映射，但性能差、不推荐用于 FrankenPHP 生产调试
- Windows 的 Hyper-V、Docker Desktop、IIS Express 默认常驻
:80/:443，是高频冲突源
怎么快速定位 Windows 主机上谁占了端口
别在 WSL 里查 lsof 或 ss —— 那只反映 WSL 内部状态。必须回到 Windows 主机查：
- 以管理员身份打开 PowerShell，执行：
netstat -ano -p TCP | findstr :8000（把8000换成你实际用的端口） - 输出最后一列是 PID；再执行：
tasklist /FI "PID eq 1234"（把1234替换为上一步得到的 PID） - 重点关注
Image Name列：若看到svchost.exe，可能关联 IIS 或 Windows 功能；若看到frankenphp.exe或php.exe，说明有旧实例没退出
解决策略：停、改、绕三选一
确认冲突源后，按风险从低到高选择操作：
立即学习“PHP免费学习笔记（深入）”；
-
停：安全终止已知无害进程，比如旧 FrankenPHP 实例：
taskkill /PID 1234 /F；避免杀PID=4（System 进程）或svchost.exe（除非你明确知道它托管的是哪个服务） -
改：修改 FrankenPHP 的
server.address配置，避开常用端口，例如设为127.0.0.1:8081或127.0.0.1:9001；注意同时更新 Nginx/Apache 反向代理配置里的proxy_pass -
绕：启用 WSL2 的
localhostForwarding隔离（需 Windows 11 22H2+），在%USERPROFILE%\AppData\Local\Packages\...\wsl.conf中添加：[wsl2] localhostForwarding=true
，然后重启 WSL（wsl --shutdown），可阻止 WSL 端口自动映射到 Windows 主机
最易被忽略的一点：WSL 中 FrankenPHP 启动后，别只在 WSL 里 curl http://localhost:8000 测试——务必也在 Windows 主机浏览器中访问 http://localhost:8000，才能真实验证端口是否真正可用。很多“启动成功但无法访问”的问题，根源就在这里。
