Appearance
问题现象
用户在移动端点击“联系客服”时,页面提示: 当前暂无客服在线、客服正在忙碌中 或无法打开聊天会话窗口。
常见原因与排查步骤
测试账号与客服账号关联了同一个用户(UID 冲突)
- 现象:测试人员在电脑端登录了客服工作台,用自己的手机微信打开商城发起咨询,提示不在线。
- 根本原因:系统在线客服逻辑中,自动排除了与当前发起咨询用户相同
uid的客服坐席(防止自己与自己产生死循环聊天)。 - 解决:换一个未绑定该客服坐席的独立微信账号进行移动端咨询测试,或新建一个独立的测试客服账号。
客服坐席未处于“在线/空闲”状态
- 客服人员必须通过专用客服工作台链接登录,并确保右上角状态切换为 【在线】。
- 若客服长时间无操作触发了离线超时,请刷新工作台重新连接。
WebSocket 服务通信异常
EBAOZU 在线客服依赖 WebSocket 维持长连接通信:
- 检查服务器常驻 Swoole 服务是否正常运行(
supervisorctl status)。 - 打开浏览器开发者工具(F12)->【Network】->【WS】,检查 WebSocket 是否成功建立连接(状态码
101 Switching Protocols)。 - 确保 Nginx 反向代理中包含了 WebSocket 升级头配置:nginx
proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";