UDP端口被占用时lsof -i :端口号查不到进程,需加-U参数:lsof -iU :8282;仍无结果则用ss -uln或netstat -uln,注意IPv6(:::8282)和TCP/UDP端口空间独立。

UDP端口被占用时lsof -i :端口号查不到进程?
UDP是无连接协议,lsof -i :8282 默认可能不显示仅处于监听状态的UDP进程(尤其在某些Linux发行版或容器环境中)。这不是命令失效,而是UDP socket未主动发包时系统不会建立完整连接记录。
必须加 -U 参数强制查UDP:lsof -iU :8282。如果仍为空,再试 ss -uln | grep :8282 或 netstat -uln | grep :8282——这两个命令对UDP监听更敏感。
- Alpine镜像默认没装
lsof,用apk add lsof;Ubuntu/Debian用apt install lsof -
ss -uln比netstat更轻量,且无需root权限就能看到本地监听端口 - 别只查
0.0.0.0:8282,IPv6地址:::8282也可能被占,ss -uln会同时列出两者
Workerman UDP worker启动报Address already in use,但ps里没看到php进程?
UDP worker异常退出后,内核socket资源可能未释放(尤其在kill -9主进程后),导致端口仍被标记为“in use”,但对应进程已不存在——这是典型的TIME_WAIT残留或内核资源泄漏。
此时不能靠ps找进程,得直接释放端口:
- 重启Workerman前加清理:在
start.php开头插入exec("ss -uln | grep :8282 | awk '{print \$5}' | xargs -r kill -9 2>/dev/null");(仅限开发环境) - 换端口最稳妥:把
new Worker("udp://0.0.0.0:8282")改成new Worker("udp://0.0.0.0:8283"),避免死磕 - 检查是否多个Worker实例绑了同一UDP端口——UDP不支持
SO_REUSEADDR多进程共享监听,必须严格一对一
为什么改了TCP端口,UDP端口还报冲突?
Workerman项目常混用TCP和UDP服务(比如TCP做管理通道、UDP收设备心跳),但开发者容易忽略:TCP和UDP端口空间是独立的,8282被TCP占着,不代表UDP:8282就空闲;反之亦然。报错里的端口号,必须严格对应你UDP worker代码中写的那个数字。
常见误操作:
- 复制TCP配置改端口时,漏改协议头,写成
"tcp://0.0.0.0:8282"却当成UDP用 - GatewayWorker架构下,register worker默认走TCP,但业务层UDP worker另起一套,两者的端口配置完全不互通,需分别确认
- 防火墙或SELinux可能拦截UDP绑定(尤其是非特权端口Address already in use,实际是权限拒绝
docker里跑Workerman UDP服务总报端口冲突?
Docker默认网络模式下,UDP端口映射比TCP更脆弱:宿主机上一个UDP包发到映射端口,Docker daemon可能无法正确分发给容器内进程,内核会认为该端口“已被占用”。
关键动作:
- 启动容器时加
--network host绕过NAT层(适合开发调试) - 确保
docker run用了-p 8282:8282/udp,斜杠后必须明确写/udp,否则默认只映射TCP - Alpine基础镜像里
nc不支持UDP扫描,验证端口要用echo "test" | socat - udp4-sendto:127.0.0.1:8282,再看容器日志是否有收包
UDP端口冲突的根因往往藏在协议特性与系统行为的夹缝里——它不像TCP有清晰的连接状态可查,排查时得放弃“一定有进程在跑”的预设,优先验证端口本身是否真可用。











