frankenphp启动失败提示socket占用，本质是监听端口（如127.0.0.1:8000）被其他进程占用；需三步处理：一查占用进程（netstat -ano | findstr :端口 + tasklist），二判别安全终止（如旧frankenphp可kill，pid=4的system不可杀），三改配置文件中server.address为未占端口。
FrankenPHP 启动失败提示 socket 占用，本质是它尝试监听的端口（默认 127.0.0.1:8000 或你配置的其他地址+端口）已被另一个进程抢先绑定。这不是 FrankenPHP 自身代码问题，而是系统级资源冲突。处理核心就三步：确认谁在占、判断能否杀、选择停进程或改端口。
第一步：查清哪个进程占了 socket
以管理员身份打开命令提示符（CMD）或 PowerShell，执行： ```cmd netstat -ano | findstr :8000 ``` 把 `8000` 换成你实际报错的端口号（比如 `:9000`、`:80` 或 `:443`）。输出中最后一列数字就是 PID。 再运行： ```cmd tasklist | findstr "1234" ``` 把 `1234` 换成上一步查到的 PID。重点看返回的进程名，常见情况有：- 显示
frankenphp.exe→ 是旧实例没退出干净，可安全终止 - 显示
php.exe或php-cgi.exe→ 可能是其他 PHP 服务（如 PHP built-in server）在跑 - 显示
System且 PID = 4 → 极大概率是 Windows 的 HTTP.sys 驱动占着 80/443，不能 kill - 显示
Skype.exe、Zoom.exe、com.docker.backend.exe→ 用户软件，可终止 - 显示
svchost.exe→ 要结合services.msc查具体服务，别盲目杀
第二步：安全终止或停用占用进程
- 如果是 FrankenPHP 自身旧进程：直接 `taskkill /F /PID 1234` - 如果是 `php -S` 或其他开发服务器：同样 `taskkill /F /PID 1234` - 如果是 Skype、Zoom 等桌面软件：关掉对应程序即可，无需命令行 - 如果 PID = 4（System + HTTP.sys）： → 打开 `services.msc` → 找到并停止以下服务（右键 → 停止，再双击设“启动类型”为「禁用」）：- World Wide Web Publishing Service（W3SVC）
- Web Deployment Agent Service
- SQL Server Reporting Services（如有）
第三步：改 FrankenPHP 监听端口（推荐长期方案）
修改配置比反复清理端口更稳妥，尤其适合多环境共存场景。FrankenPHP 使用 TOML 配置文件（如 `frankenphp.toml`），需改两处：- 找到
server段下的address，例如：[server] address = "127.0.0.1:8000"
改成空闲端口，如
"127.0.0.1:8001" - 如果启用了 HTTPS，同步改
tls.address（如有）：tls.address = "127.0.0.1:8443"
改完保存，重新运行 frankenphp serve。浏览器访问 http://127.0.0.1:8001 测试是否生效。
额外提醒：避免重复启动和残留
- 启动前先执行 `tasklist | findstr "frankenphp"`，确保没有后台实例 - 不要用 Ctrl+C 中断后直接重试，有时进程未完全退出；可加个 `timeout 2` 再启动 - 如果用的是 WSL 或 Docker 封装的 FrankenPHP，检查宿主机和容器内端口是否双重绑定不复杂但容易忽略
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
