确认是 frankenphp 自身残留：macos/linux 运行 lsof -p -n -i :2019 查 command 是否为 frankenphp 或含 php-server 的 php 进程；windows 管理员下执行 netstat -ano | findstr :2019 获取 pid 后，再用 tasklist | findstr "pid" 检查映像名或命令行是否含 frankenphp.exe 或 --addr :2019；若无进程但启动仍失败，则极可能是 /tmp/frankenphp.sock 文件残留导致误判端口冲突。
FrankenPHP 关闭站点后 2019 端口仍在监听，基本可以断定：不是别人占了，而是 FrankenPHP 自己没退干净——进程还挂着，socket 没释放，Ctrl+C 或 IDE 停止按钮根本没真正杀掉它。
怎么确认是 FrankenPHP 自己残留（不是系统或其他软件）
别信日志或终端提示“已停止”，直接查系统级绑定状态：
- macOS/Linux：
lsof -P -n -i :2019，看COMMAND列是不是frankenphp或带php-server的php进程 - Windows（管理员权限）：
netstat -ano | findstr :2019，拿到 PID 后再跑tasklist | findstr "PID"，若映像名为frankenphp.exe或命令行含--addr :2019，就是它自己 - 特别注意：如果查不到任何进程但启动仍失败，可能是
/tmp/frankenphp.sock文件残留导致 FrankenPHP 启动时误判端口冲突（尤其在 Symfony 场景下）
为什么 Ctrl+C 和 IDE 终止按钮无效
FrankenPHP 启动后会派生子进程、建立 Unix socket、注册信号处理器。很多终端/IDE 只发送 SIGINT 给前台进程组，但 worker 或 messenger 进程可能忽略它，或因 ignore_user_abort(true) 继续运行：
- Linux/macOS 下，
ps aux | grep "frankenphp\|messenger:consume"常能挖出隐藏进程 - Windows 下，
tasklist | findstr "php.exe"要配合tasklist /FI "IMAGENAME eq php.exe" /V查完整命令行，才能发现php bin/console messenger:consume这类伪装成普通 PHP 的长驻任务 - 强行
kill -9或taskkill /F /PID容易留下孤儿进程和/tmp/frankenphp.sock，下次启动直接报错
安全清理残留的实操步骤
目标是让 FrankenPHP 自己优雅退出，而不是暴力清场：
- macOS/Linux：先
kill -15 PID，等 3 秒，再ps -p PID确认是否退出；未响应再kill -9 PID；最后rm -f /tmp/frankenphp.sock - Windows：用
taskkill /PID 1234（不加/F），比强杀更稳妥；若失败再补/F；同时手动删掉C:\Users\XXX\AppData\Local\Temp\frankenphp.sock类路径下的残留文件 - 别用
taskkill /F /IM php.exe或pkill php——它会干掉正在运行的新 FrankenPHP 实例，尤其是你开多个终端调试时
容器内监听 2019 端口却访问不到？重点检查这个
容器里 netstat -tlnp | grep :2019 显示 127.0.0.1:2019 是常见假象——这表示只监听容器内部回环，宿主机根本连不上：
- 必须看到
0.0.0.0:2019或*:2019才算对外暴露 - 启动命令要透传
-- -listen 0.0.0.0:2019（注意双短横），或设环境变量SERVER_NAME=:2019 -
docker run -p 2019:2019只是转发，前提是容器内真有进程在0.0.0.0:2019上等着接连接
最易被忽略的是：残留 socket 文件比残留进程更顽固，/tmp/frankenphp.sock 不删，下次启动 FrankenPHP 会主动放弃绑定端口，直接报错——它宁可不启，也不愿复用旧 socket。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
