FrankenPHP启动报“端口占用”本质是监听端口（默认8080）被其他进程抢占，需先用netstat/tasklist精准定位PID及进程名，再依类型处理：用户程序可安全终止，System（PID=4）或Docker须禁用服务或停容器，长期推荐修改frankenphp.yaml或启动参数换端口。
FrankenPHP 启动时报“端口占用”，本质是它尝试监听的端口（默认 8080 或你配置的其他端口）已被系统中另一个进程抢先绑定。这不是 FrankenPHP 本身代码出错，而是资源冲突问题。排查关键在于：**先精准定位谁在用这个端口，再决定是停掉它、禁用服务，还是改 FrankenPHP 的监听端口。**
第一步：确认被占的是哪个端口
FrankenPHP 默认监听 8080，但你可能在 frankenphp.yaml 或命令行中改过（比如 --addr :80）。先检查你的启动方式：
- 如果用
frankenphp serve，默认是:8080 - 如果用
frankenphp run，看是否带了--addr参数 - 如果用 systemd 或 Docker，检查配置文件里写的
ADDR或ports
确定端口号后，才能下一步查占用者。
第二步：用 netstat + tasklist 找出真凶
以管理员身份打开命令提示符（Windows）或终端（Linux/macOS），执行：
立即学习“PHP免费学习笔记（深入）”；
-
Windows：
netstat -ano | findstr :8080（把 8080 换成你实际的端口）→ 记下最后一列的 PID -
Linux/macOS：
sudo lsof -i :8080或sudo netstat -tuln | grep :8080
拿到 PID 后，再查进程名：
- Windows：
tasklist | findstr "1234"（1234 是你查到的 PID） - Linux：
ps -p 1234 -o comm=
重点看输出结果：如果是 frankenphp 自身的老进程、php、nginx、node 或 Skype 这类用户程序，可安全终止；如果是 System（PID=4）、svchost.exe 或 dockerd，就得谨慎处理。
第三步：按进程类型选择处理方式
不要一看到 PID 就 taskkill /F —— 错杀系统进程可能引发蓝屏或服务中断：
-
PID 是 4 且显示 System：这是 Windows 的 HTTP.sys 驱动在占 80/443/8080，不能 kill。应进
services.msc禁用 “World Wide Web Publishing Service” 和 “Web Deployment Agent Service” -
是 docker 或 containerd：说明有容器映射了该端口，运行
docker ps查具体容器，用docker stop 容器名停掉，别直接杀宿主机进程 -
是旧的 FrankenPHP 或 PHP 内置服务器：用
taskkill /F /PID 1234（Windows）或kill -9 1234（Linux）即可 - 是 Skype、Zoom、TeamViewer：这类软件常静默占端口，关闭其客户端或进设置里关掉“使用 80/443 作为替代端口”选项更稳妥
第四步：修改 FrankenPHP 监听端口（推荐长期方案）
与其反复抢端口，不如换一个干净端口。修改方式取决于你的启动方式：
-
命令行启动：直接加参数，例如
frankenphp serve --addr :8000 -
使用 frankenphp.yaml：在文件中添加或修改
server: addr: ":8000" -
Docker 启动：改
docker run -p 8000:8000，同时确保容器内 FrankenPHP 配置也监听:8000
改完后，记得访问 http://localhost:8000 测试，别还去刷老端口。
