端口被占用需按顺序排查：先用lsof或netstat查PID，再杀残留子进程，检查GatewayWorker的register地址是否同步，最后确认防火墙/SELinux是否拦截。
Workerman WebSocket 启动时报 Address already in use，基本可以确定是端口被占——不是代码写错了，而是系统层面的资源冲突。直接杀进程、换端口都治标不治本，得按顺序查清“谁在用”“为什么没退干净”“有没有连带配置漏改”。
怎么快速定位占用 websocket://0.0.0.0:2346 的进程
别猜，直接查。你监听的是哪个端口（比如 2346），就查哪个：
- Linux/macOS：运行
lsof -i :2346，输出里会带 PID 和 COMMAND，一眼就能看出是 php、node 还是别的服务在占 - 如果提示
command not found，Alpine 镜像跑apk add lsof，Ubuntu/Debian 跑apt install lsof - Windows：先
netstat -ano | findstr :2346拿到 PID，再tasklist | findstr 12345（把 12345 换成上一步的 PID）确认进程名 -
注意：
lsof -i :2346会同时覆盖 IPv4（0.0.0.0:2346）和 IPv6（:::2346），别只盯着一个地址查漏
为什么 php start.php stop 后端口还在被占
Workerman 是多进程模型，主进程 fork 出一堆 worker。一旦异常退出（比如 Ctrl+C、kill -9、断电），子进程可能还卡在后台继续 bind 端口，而 stop 命令只管主进程 PID，对这些“孤儿”无效。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
- 先手动扫一遍残留：
ps aux | grep "start.php"或ps aux | grep YourAppPath - 别只 kill 主进程 PID——要一锅端：
kill -9 $(pgrep -f "YourAppPath/start.php") - 开发环境可临时加清理逻辑（生产禁用）：在
start.php开头插入exec("killall -u $(whoami) php 2>/dev/null"); - 常见错觉：日志里只报一句
Address already in use，根本不会提醒你“有 4 个子进程还在 ESTABLISHED 状态”
GatewayWorker 架构下 register 地址不同步也会触发端口冲突
GatewayWorker 有两层监听：业务 worker（比如 websocket://0.0.0.0:2346）和 register worker（默认 127.0.0.1:1236）。改了业务端口，但 register 还在旧地址 listen，或者客户端连的仍是旧 register，就会导致启动失败或连接不上。
- 启动时显式指定 register 新地址：
php start.php start -d --register-addr=127.0.0.1:1237 - 检查
start_register.php里 register worker 的监听配置，确保 IP 和端口与业务 worker 初始化时传入的一致 - 客户端连接代码里的 register 地址必须同步更新，否则服务端启动成功，客户端也注册不进去
防火墙或 SELinux 拦截会让连接看起来像端口被占
有时候 lsof 和 netstat 都查不到占用者，但客户端连上来就是 ERR_CONNECTION_REFUSED，这时候问题不在 Workerman 自身，而在系统网络策略。
- CentOS/Alibaba Cloud Linux：检查 firewall-cmd 是否放行了你的端口，比如
firewall-cmd --permanent --add-port=2346/tcp，然后firewall-cmd --reload - 宝塔用户：安全 → 放行端口 → 添加
2346 - SELinux 启用状态下，可能需要
setsebool -P httpd_can_network_connect 1（仅限 HTTP/WebSocket 场景） - 本地开发用
localhost测试没问题，但部署到服务器后连不上，优先怀疑这层拦截
真正麻烦的不是端口被占，而是你以为它被占了——结果查半天是 register 地址没同步、客户端连错地址、防火墙挡着，或者 pidFile 失效导致 stop 命令压根没起作用。每一步都要验证，别跳步骤。
