thinkphp5.0集成workerman websocket连接失败排查指南
本文针对ThinkPHP 5.0框架集成Workerman WebSocket服务连接失败问题，提供详细的排查步骤。 问题表现为：服务端看似正常运行，但客户端JavaScript代码无法连接，尝试了本地IP(127.0.0.1)、0.0.0.0和公网IP均失败。环境为TP5.0.24、Workerman 3.5.31、PHP 5.6.40、Linux+宝塔面板，2222端口已开放。
代码层面（已知正常，仅供参考）：
-
服务端控制器(WorkerController.php): 正确定义了WebSocket监听地址(例如：
websocket://127.0.0.1:2222)，并实现了必要的回调函数(onMessage, onConnect, onClose, onError)。 - 客户端代码(JS): 尝试连接ws://[服务器IP]:2222 (使用公网IP或本地IP)。
-
启动脚本(server.php): 正确加载ThinkPHP框架，并设置
BIND_MODULE为push/Worker。
排查步骤：
立即学习“PHP免费学习笔记（深入）”；
-
防火墙验证： 即使已开放2222端口，仍需检查服务器防火墙(系统防火墙和宝塔面板防火墙)是否真正允许外部访问2222端口。 使用相关命令确认防火墙规则。
-
IP地址确认： 验证47...57是否为服务器的真实公网IP地址。使用
ifconfig或类似命令确认。 如果服务器在内网，需检查内网网络配置，确保服务器可被外部访问。 -
server.php执行路径： 确认
server.php的执行路径是否正确，特别是thinkphp/start.php的相对路径。 -
Workerman安装及配置： 检查
composer.json文件，确保workerman/workerman依赖已正确安装，版本与描述一致。 -
PHP版本兼容性： PHP 5.6.40版本较旧，可能与Workerman或ThinkPHP存在兼容性问题。 建议升级到PHP 7.4或更高版本。
-
端口冲突： 使用
netstat -tulnp | grep 2222(Linux) 或类似命令，检查是否有其他程序占用2222端口。 -
日志检查： Workerman通常会生成日志文件，仔细检查日志文件，寻找连接失败的详细信息和错误提示。
通过以上步骤，逐一排查，逐步缩小问题范围，最终找到并解决WebSocket连接失败的原因。 记住，仔细检查每个步骤，并记录下你的操作和结果，这将有助于你更快地解决问题。
