HELP CENTER
遇到问题，先在这里找到明确答案
部署、运行、客户端、授权、下载、安全和数据问题都按分类持续整理。
常见问题
按真实部署和售后场景持续补充
运行问题
→网站出现 502 Bad Gateway 怎么排查
502 通常表示 Nginx 无法从 PHP-FPM、WebSocket 或其他上游服务取得正常响应。
资料参考：Nginx 官方项目资料运行问题
→Workerman 如何启动、停止和查看状态
说明 start、stop、restart、reload、status 和守护运行的基本原则。
资料参考：Workerman 官方手册运行问题
→WebSocket 连接返回 1006
排查 WSS、反向代理、心跳、鉴权、超时和服务端异常退出。
资料参考：Workerman 官方手册运行问题
→消息需要刷新后才出现
修复 WebSocket 事件未更新前端状态的问题。
资料参考：青码科技技术支持中心运行问题
→新好友申请没有红点
检查好友申请事件、未读计数、WebSocket 推送和已读接口。
资料参考：青码科技技术支持中心运行问题
→同一条消息出现两次
通过客户端消息号、唯一索引和幂等响应消除重复消息。
资料参考：青码科技技术支持中心运行问题
→Workerman 如何启动、停止和查看状态
使用 start、stop、restart、reload 和 status 命令管理长连接进程。
资料参考：Workerman 官方手册运行问题
→群聊部分成员收不到消息
检查成员关系、在线路由、多节点广播、群缓存和离线任务。
资料参考：青码科技技术支持中心运行问题
→数据库升级后提示字段不存在
确认覆盖文件与 SQL 补丁属于同一版本，并检查升级记录。
资料参考：青码科技技术支持中心运行问题
→PHP 页面白屏或返回 500
先关闭前端猜测，直接查看 PHP 错误日志和 Nginx 错误日志。
资料参考：PHP 官方手册运行问题
→API 返回 401、403 或登录状态失效
从令牌、设备、账号状态、权限和服务器时间逐层排查。
资料参考：青码即时通讯开发文档运行问题
→WebSocket 连接后提示 auth timeout
连接成功后没有在限定时间内完成身份认证。
资料参考：青码即时通讯开发文档运行问题
→推送任务或消息派发任务持续积压
检查任务进程、第三方响应、失败重试、数据库锁和处理批次。
资料参考：青码科技技术支持中心运行问题
→计划任务或队列没有执行
定时任务需要正确的 PHP 命令、绝对路径、运行用户和日志输出。
运行问题
→后台或前台 CSS 全部丢失
通常是网站根目录、运行目录、资源路径或反向代理前缀配置错误。