ThinkPHP 5.0集成Workerman构建WebSocket服务时，浏览器连接失败的排查指南
本文针对在Linux环境下使用ThinkPHP 5.0和Workerman 3.5.31搭建WebSocket服务，浏览器却无法建立连接的问题，提供详细的分析和解决方案。 问题表现为：服务器端看似正常运行，但浏览器JavaScript代码始终无法连接，尝试过127.0.0.1、0.0.0.0和服务器公网IP，均失败。
系统环境:
- 框架：ThinkPHP 5.0.24
- Workerman：3.5.31
- PHP：5.6.40
- 系统：Linux + 宝塔面板
- 端口：2222 (已开放)
代码结构分析:
立即学习“PHP免费学习笔记（深入）”；
服务端代码 (app\push\controller\WorkerController.php) 实现了WebSocket服务器的核心功能，包括连接建立、消息处理、连接关闭和错误处理等回调函数。 关键在于 $socket 属性，它定义了监听地址。
客户端JavaScript代码尝试连接 ws://47.***.***.57:2222 (服务器公网IP)，连接失败后尝试 ws://127.0.0.1:2222 (本地地址)。
server.php 是Workerman服务的入口文件，负责加载ThinkPHP框架并指定运行模块为 push/Worker。
问题原因及解决方法:
连接失败的原因可能如下：
-
防火墙: 即使端口2222已开放，服务器防火墙 (例如iptables) 仍可能阻止外部访问。 需要检查并配置防火墙规则，允许2222端口的入站连接。
-
$socket配置:WorkerController.php中的$socket属性websocket://127.0.0.1:2222只监听本地连接。 要允许外部访问，需修改为websocket://0.0.0.0:2222，监听所有可用网络接口。 -
宝塔面板设置: 宝塔面板可能存在额外的安全限制。 检查宝塔面板的防火墙和安全设置，确保2222端口可被访问。
-
服务器IP地址: 验证
47.***.***.57是否为服务器正确的公网IP地址。 使用ifconfig或ip addr命令确认。 -
PHP版本兼容性: PHP 5.6版本可能与Workerman存在兼容性问题。 建议升级到PHP 7.x或更高版本。
-
ThinkPHP配置: 检查ThinkPHP框架配置，确保Workerman服务能正确加载和运行。
建议排查步骤:
首先，将 $socket 属性修改为 websocket://0.0.0.0:2222，这是解决问题的关键。 然后，依次检查防火墙、宝塔面板设置、服务器IP地址、PHP版本和ThinkPHP配置。 确保所有步骤都正确配置后，重新启动Workerman服务。
