Workerman WebSocket端口被占用怎么办-Workerman-PHP中文网

端口被占用需按顺序排查：先用lsof或netstat查pid，再杀残留子进程，检查gatewayworker的register地址是否同步，最后确认防火墙/selinux是否拦截。

workerman websocket端口被占用怎么办

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

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 命令压根没起作用。每一步都要验证，别跳步骤。