优化菜单 5G消息

网站用户头像上传后不显示

1. 检查头像上传路径是否正确，文件是否保存成功；2. 核实页面头像加载路径是否正确；3. 修复头像裁剪逻辑，确保图片格式 / 尺寸符合要求；4. 清除浏览器缓存，测试最新头像

网站视频无法全屏播放，提示 “不支持全屏”

1. 检查视频元素是否添加了 allowfullscreen 属性；2. 修复浏览器全屏 API 调用，兼容不同内核（webkitRequestFullscreen）；3. 核实视频是否处于 iframe 中，iframe 是否设置了 allowfullscreen；4. 更换视频播放器插件，排查插件功能限制

网站 WebSocket 连接频繁断开重连

1. 检查服务器是否开启心跳机制，维持连接；2. 修复客户端重连逻辑，设置合理的重连间隔；3. 核实网络环境是否稳定，避免防火墙拦截；4. 优化 WebSocket 数据传输，避免过大数据包导致断开

网站表格合并单元格后排序 / 筛选失效

1. 修复排序 / 筛选算法，确保正确识别合并单元格的数据；2. 避免合并关键数据列，只合并展示性列（如备注）；3. 排序 / 筛选时临时取消合并，排序完成后重新合并；4. 提示用户合并单元格后排序可能影响结果，建议先取消合并

网站日期选择器显示的日期与系统日期不一致

1. 检查日期选择器的时区配置，是否与系统时区一致；2. 修复日期计算逻辑，避免时区转换错误；3. 核实客户端系统日期是否正确，无时间偏差；4. 手动校准日期选择器的基准时间，确保显示准确

网站 AJAX 请求返回 504 网关超时

1. 检查后端接口响应时间是否过长，优化接口性能；2. 修复 Web 服务器（Nginx）的超时配置（如 proxy_connect_timeout）；3. 核实后端服务是否正常运行，无宕机或过载；4. 分拆大请求为多个小请求，减少单次请求耗时

网站显示 “504 Gateway Timeout” 错误

1. 调整 Nginx 的 fastcgi_connect_timeout、fastcgi_read_timeout 参数；2. 排查 PHP 层资源不足问题，扩容服务器或优化代码；3. 检查数据库连接数是否达到上限，调整连接池配置；4. 优化耗时操作（如外部接口调用、大数据查询）

网站 API 接口限流触发，无法访问

1. 检查限流配置（如 QPS 阈值）是否合理；2. 优化请求频率，避免频繁调用；3. 申请提高限流阈值，适配业务需求；4. 实现限流降级方案，返回友好提示

网站视频在线播放卡顿

1. 提供多码率视频，适配不同网络速度；2. 启用视频分段加载，避免缓冲等待；3. 优化视频服务器带宽，提升传输速度；4. 采用 CDN 加速视频分发，减少延迟