遇到问题，先在这里找到明确答案
部署、运行、客户端、授权、下载、安全和数据问题都按分类持续整理。
常见问题
按真实部署和售后场景持续补充
PHP 页面白屏或返回 500 怎么排查
从错误日志、PHP 版本、扩展、权限和入口文件定位白屏或 HTTP 500。
资料参考：PHP 官方手册PHP 上传文件提示过大或没有反应
需要同时检查 upload_max_filesize、post_max_size、临时目录权限和执行时间。
资料参考：PHP 官方手册Nginx 出现 502 Bad Gateway
检查 PHP-FPM、Workerman 反向代理、端口监听、超时和进程状态。
资料参考：青码科技技术支持中心MySQL 提示 Access denied
核对数据库账号、密码、主机授权和宝塔数据库权限。
资料参考：MySQL 官方文档H5 刷新二级页面后出现 404
为前端 history 路由配置 Nginx 回退，或改用 hash 路由。
资料参考：Nginx 官方文档上传图片或文件失败
同时检查 PHP、Nginx、目录权限、MIME、磁盘空间和对象存储。
资料参考：PHP 官方手册宝塔计划任务没有执行
检查命令路径、PHP CLI 版本、工作目录、权限和任务日志。
资料参考：青码科技技术支持中心网站出现 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 补丁属于同一版本，并检查升级记录。
资料参考：青码科技技术支持中心UniPush 2.0 收不到离线通知
从正式包、push_clientid、厂商配置、设备绑定和任务进程逐层检查。
资料参考：DCloud uni-app 官方文档App 能登录但 H5 或 PC 无法登录
检查跨域、Cookie、Token 存储、接口域名和 HTTPS 混合内容。
资料参考：青码科技技术支持中心手机锁屏后 WebSocket 断开
说明移动系统后台限制与前台重连、离线推送的正确配合。
资料参考：青码科技技术支持中心UniPush 2.0 收不到离线通知
先确认 HBuilderX、manifest、push_clientid、厂商通道和正式包配置。
资料参考：DCloud uni-app 官方文档PC 与手机消息不同步
统一使用服务端会话、消息历史和已读位置实现多端同步。
资料参考：青码科技技术支持中心头像、图片在 App 正常但 H5 不显示
检查 HTTPS、跨域、鉴权 URL、Referer 防盗链和对象存储规则。
资料参考：青码科技技术支持中心授权查询显示有效但程序提示未授权
核对产品代码、目标绑定、版本、公钥、时间和不同进程配置。
资料参考：青码科技技术支持中心授权中心短暂离线时程序能否运行
解释在线验证、签名离线凭证、离线期限和撤销延迟。
资料参考：青码科技授权中心文档下载中心显示暂未提供
说明后台未配置本地安全文件或网盘链接时的正常状态。
资料参考：青码科技技术支持中心PHP 页面白屏或返回 500
先关闭前端猜测，直接查看 PHP 错误日志和 Nginx 错误日志。
资料参考：PHP 官方手册正版授权证书无法下载
检查查询会话、短期证书令牌、授权状态和浏览器拦截。
资料参考：青码科技授权中心文档后台 IP 白名单设置后进不去
说明真实出口 IP、代理/CDN、CIDR 和应急恢复方法。
资料参考：青码科技安全中心文档数据库应该怎么备份和恢复
建立每日备份、异地保存、加密密钥备份和恢复演练。
资料参考：青码科技安全中心文档完整性扫描发现文件被修改
判断正常升级、人工修改和异常入侵，正确更新可信基线。
资料参考：青码科技安全中心文档如何保护授权中心的密钥文件
说明 app_key、Vault 密钥环、产品私钥、权限和异地备份。
资料参考：青码科技安全中心文档授权查询正常但程序仍提示未授权
检查产品代码、授权码、绑定目标、版本号、公钥和客户端缓存。
PHP 文件加密后还能被破解吗
说明源码加密能提高成本，但不能对 root 权限攻击者承诺绝对不可逆。
资料参考：青码安全架构说明API 返回 401、403 或登录状态失效
从令牌、设备、账号状态、权限和服务器时间逐层排查。
资料参考：青码即时通讯开发文档WebSocket 连接后提示 auth timeout
连接成功后没有在限定时间内完成身份认证。
资料参考：青码即时通讯开发文档推送任务或消息派发任务持续积压
检查任务进程、第三方响应、失败重试、数据库锁和处理批次。
资料参考：青码科技技术支持中心扫码登录一直停留在等待确认
检查二维码票据过期、手机确认、轮询或实时事件和设备绑定。
资料参考：青码即时通讯使用文档数据库备份后如何确认可以恢复
只有实际恢复演练成功的备份才算有效备份。
语音或视频通话没有声音和画面
检查权限、HTTPS、RTC 配置、房间凭证、设备占用和网络环境。
资料参考：青码科技技术支持中心后台登录后反复跳回登录页面
检查 HTTPS、Session 保存目录、Cookie、反向代理和服务器时间。
资料参考：青码授权中心安全文档授权版本不匹配或升级后被拒绝
确认产品代码、程序版本、授权允许版本和云版本设置。
资料参考：青码授权中心文档升级后提示字段不存在或数据表不存在
通常是覆盖了程序文件但没有执行对应数据库升级。
上传图片或文件失败
除了 PHP 上传限制，还要检查目录权限、文件类型、磁盘空间和 open_basedir。
资料参考：PHP 官方手册计划任务或队列没有执行
定时任务需要正确的 PHP 命令、绝对路径、运行用户和日志输出。
HTTPS 正常但 WSS 连接失败
网页使用 HTTPS 时，WebSocket 必须使用 WSS，并由 Nginx 反向代理到内部端口。
后台或前台 CSS 全部丢失
通常是网站根目录、运行目录、资源路径或反向代理前缀配置错误。
程序响应变慢或并发上升后超时
先区分 PHP、MySQL、WebSocket、外部接口和磁盘 I/O，再针对瓶颈优化。