Workerman TCP连接失败怎么排查

雨明吖_1244

雨明吖_1244

2026-09-10

599人浏览

原创

ss -tuln无输出说明Workerman未成功监听端口,主因是onWorkerStart异常、端口占用、缺失sockets/pcntl扩展或监听地址写为127.0.0.1;须改0.0.0.0并完整重启。

workerman tcp连接失败怎么排查

ss -tuln 看不到端口说明根本没监听

客户端 telnet 报 Connection refused,第一反应不该是改代码,而是确认内核是否真在监听。运行 ss -tuln | grep :你的端口(比如 :2345),若无任何输出,说明 Workerman 进程压根没成功 bind 端口。

常见原因包括:

  • onWorkerStart 里抛了未捕获异常,导致 worker 进程启动失败——此时 ps aux | grep WorkerMan 只能看到 master process,看不到 worker process
  • 端口被其他进程占着,lsof -i :2345 或 netstat -tuln | grep :2345 能查到 PID,需 kill -9 清理
  • PHP 缺 sockets 扩展,或 pcntl_fork 被禁用,Workerman 启动时静默失败
  • 监听地址写成 tcp://127.0.0.1:2345,但 ss 查的是 *:2345,自然不匹配

ss 显示 127.0.0.1:端口 ≠ 外部能连

看到 127.0.0.1:2345 就以为“服务起来了”,是排查中最常踩的坑。这个地址只响应本机回环流量,硬件设备、手机、另一台服务器发包到你的真实 IP,Linux 内核直接丢弃,不进防火墙,也不进 Workerman。

必须改成 tcp://0.0.0.0:2345 或 tcp://*:2345,然后完整重启:php start.php stop && php start.php start。热重载(reload)不重建监听 socket,旧配置还在内核里。

重启后再次 ss -tuln | grep :2345,目标是看到 *:2345 或 0.0.0.0:2345。

telnet 通 localhost ≠ 客户端能连

在 Workerman 服务器上 telnet 127.0.0.1 2345 成功,只验证了 loopback 通;客户端连不上,问题一定出在中间链路。

Pic Copilot
Pic Copilot

Pic Copilot是阿里国际推出的面向电商卖家的 AI 商品图和营销设计工具。

下载

必须从客户端机器执行真实测试:

  • 嵌入式设备(ESP32/STM32):用串口工具发 AT+CIPSTART="TCP","your-server-ip",2345
  • Linux/macOS 客户端:telnet your-server-ip 2345
  • Windows 客户端:telnet your-server-ip 2345(需先启用 Telnet 客户端功能)

不通就按顺序查:

  • 云平台安全组(阿里云/腾讯云):入方向规则是否添加 TCP + 对应端口 + 源 IP 是 0.0.0.0/0?别信截图,手动点开确认状态为「启用」
  • 宿主机防火墙:firewall-cmd --list-ports 看端口是否开放;没开就加:firewall-cmd --add-port=2345/tcp --permanent && firewall-cmd --reload
  • Docker 场景:容器启动是否带 -p 2345:2345?容器内监听地址是否也是 0.0.0.0:2345?

连上了但收不到数据,先看协议匹配不匹配

硬件模块连上 TCP socket 后立刻断开,或 onMessage 根本不触发,大概率是协议错配。

纯 TCP 设备(如大多数单片机)发的是裸字节流,但你的 Workerman 启动的是:

  • websocket://0.0.0.0:2345 → 需要 WebSocket 握手,裸 TCP 包会被直接拒绝
  • http://0.0.0.0:2345 → 需要合法 HTTP 请求头,原始 hello 字符串不会触发 onMessage
  • ssl://0.0.0.0:2345 → 没 TLS 握手,连接建立即断

确认设备侧协议后,Workerman 必须用对应协议启动。最简单验证方式:用 nc your-server-ip 2345 发纯文本,看 onMessage 是否收到——如果收不到,八成是协议不一致。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

workerman

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

2026.05.20

226

15

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

2026.05.20

222

12

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

2026.05.20

247

13

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

80

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

140

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

120

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Webman中文手册
Webman中文手册

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

ThinkPHP5.1完全开发手册
ThinkPHP5.1完全开发手册

共0课时 | 0人学习