坑点概述

通过Windows或Linux 启动IM常见问题

GRjquLCXgrzIPkmbuD8F7VScjBWqs5NNQ7vGnQ==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

0. 先在命令运行 php -v

XpbSJjPwLcnauWEhypM24euyebxpJ5Sz8MWTDQ==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

查看命令行php版本号,站点php版本不等于命令行版本,php版本不要超过 php 8.0

aWRfqpFBvcXgMTzjdEHRfc/Ba+BpyK9AXK5GjA==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

1. Windows 'php' 不是内部或外部命令,也不是可运行的程序

skAqpfjBYWMHxhSOwbyujZZQUHR2MxERDLmsEw==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
解决方法:
仔细查看 Windows启动文档 中的 1-2

2. 错误 Error in connection establishment net::ERR_NAME_NOT_TIMED_OUT

iNEhGMHqDzRUjFJaA5sUgwmQUO8tWEjML+OzAQ==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

websocket://0.0.0.0:7272 在客户端如果连接出现 WebSocket connection to 'ws://x.x.x.x:7272/' failed: Error in connection establishment :net::ERR_NAME_NOT_TIMED_OUT 表示防火墙拦住了设置的端口。

TypLaOKHMSVRjxtDdSBI1NtzUHZ6sxBOZZ9t/g==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

解决方法:

eSfoQgiEZOmXtKGhXHfO4TmxGt3Qa4GOm2/CyQ==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
  1. 如果CentOS安装了宝塔面板,安全 > 添加端口 > 放行 如果使用命令添加,最后 firewall-cmd reload 命令重启防火墙即可。
    宝塔安全
  2. YwbAHnKgeIMQpGtEJm4oeq3j0zxBd5SM6i+qiQ==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
  3. 以阿里云服务为例, 请检查 云服务器ECS > 网络与安全 > 安全组 找到这台服务器安全组规则,允许7272端口
    阿里云
  4. BdMzaQyToPNhxqlK7aQB2pq30R58ZJw/h6DLiA==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

3. 其他错误 PHP Waring

RlDkfxArPqMscUVBsuNpV7glM0HjZ/iVOSpYFg==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

最可能发生的错误,一般属于php版本,函数被禁用

ArbEcxpojWGCMHPeWPRtKSnCoTcssG1P8K85+Q==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
解决方法:
找到运行的PHP版本的php.ini ,禁用函数stream_socket_server去除,宝塔操作如下
禁用函数

4. 错误 unable to connect to tcp://xx.xx.xx.xx:xxxx

VRgIojGbFUEnscWSUOx0Uid/f7xBmFbS6+WDRA==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

如果启动后出现PHP Warning:  stream_socket_server(): unable to connect to tcp://xx.xx.xx.xx:xxxx (Address already in use) in xxxxx on line xxxx

GQnEsyePuFjTlcpAGjxsS65XfQePMI3fkFhsLA==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
解决方法:
通过命令netstat -anp | grep 端口号来找出哪个程序占用了端口,然后关闭对应程序释放端口。

5. 错误 stream_socket_server(): unable to connect to tcp://0.0.0.0:xxx (Permission denied)

PvLZyuwntSkMRfqmyljCGX5b/CnkHgIUYFP02A==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

如果启动后出现PHP Warning: stream_socket_server(): unable to connect to tcp://0.0.0.0:xxx (Permission denied)

eUDdERGVNnJKgHwX2bV3lNCmFLi7/WILgkzUAg==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
解决方法:
使用大于1024的端口或者使用root用户启动服务。

6. 错误 stream_socket_server(): unable to connect to tcp://xx.xx.xx.xx:xxx (Cannot assign requested address)

UvaRMpNzmwskBfKh1vmP465DGN0QfWrXmFwgGQ==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

如果启动后出现PHP Warning:  stream_socket_server(): unable to connect to tcp://xx.xx.xx.xx:xxx (Cannot assign requested address) in /home/GatewayWorker/Workerman/Worker.php on line xxxx

yFVgHQUdSnPDzekC/5iZpCm6gQ0TJFZ7DdIWHw==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
解决方法:
启动脚本ip参数写错,不是本机ip,请填写本机ip机或者填写 0.0.0.0(表示监听本机所有ip)即可解决。提示:Linux系统可以通过命令 ifconfig查看本机所有网卡ip。如果您是腾讯云用户,注意您的公网ip实际是代理服务器ip,公网ip并不属于你的服务器,所以无法通过公网ip绑定,但是可以通过0.0.0.0来绑定。

7. 启动成功也没有报错,接受不到任何消息,智能客服也没有自动回复

bAloJtXPYCRhLNagO6eMg5di4NVRDYkd/1lDRw==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

IM即时通讯启动后,客户端与UID绑定握手成功,IM服务器会定时向客户端发送心跳消息,客户端F12 调试,选择ws ,如果ws链接出错或并没有接受到心跳消息,且智能客服没有自动回复

lZpiEKVPJcWIGXenIUoN/sQ1/IjKgkI+55yziQ==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。

解决方法:

trqeOjGTbSHWNVhsfR44iWhPAGIGEsVz7UiW0w==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
  1. 检查 ws:// 地址是否正确
  2. nQiVPpWMjUNmTKAwsOwh+h8xJMCtHo6MOxqZRg==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
  3. 小程序需要使用 wss:// 且要在后台设置白名单,是否使用wss或配置是否成功 具体查看 端口 和 wss 配置
  4. yGLntXzmbsDlJiHoYoTdhnb7pKFZTJa8Mga0RQ==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
  5. addons/wanlshop/library/GatewayWorker/vendor/workerman/workerman.log,查看错误的地方在哪里再修改即可,或给我们留言
  6. YvfhSMpmraIqeDHV/grRALURgY1EIDfHrHk7DA==著作权归作者所有,未经许可,禁止转载、复制此文档的任何内容。
文档最后更新时间:2025-06-06 12:45:43
著作权归应用插件开发者所有,未经许可,禁止转载、复制此文档的任何内容。

文档
目录

深色
模式

切换
宽度