班级优化大师在线客服

网站 OCR 识别功能失效

1. 检查 OCR 接口是否正常，配置是否正确；2. 核实图片是否清晰，符合识别要求；3. 修复图片上传逻辑，确保格式 / 尺寸正确；4. 处理识别错误，提供手动输入备选

网站在线编辑文档保存失败

1. 检查文档保存接口是否正常，权限是否足够；2. 修复文档内容序列化逻辑，确保数据完整；3. 处理并发编辑冲突，添加版本控制；4. 启用自动保存功能，定期备份文档内容

网站导航栏下拉菜单 hover 时无法显示子菜单

1. 检查下拉菜单的 CSS 样式，是否设置了 display: none 且 hover 时未切换；2. 修复 hover 事件绑定，确保鼠标悬浮在父菜单时显示子菜单；3. 核实子菜单的 z-index 值，避免被其他元素遮挡；4. 调整父菜单与子菜单的间距，避免 hover 中断

网站第三方登录授权页面提示 “应用未审核”

1. 检查第三方平台（微信 / QQ）的应用审核状态，完成未审核流程；2. 核实应用的经营范围、回调地址是否与审核信息一致；3. 修复应用配置中的错误参数（如 APPID、APPSecret）；4. 测试沙箱环境授权是否正常，排查正式环境配置问题

网站 WebSocket 消息发送失败

1. 检查 WebSocket 连接状态，是否处于 OPEN 状态（readyState=1）；2. 修复消息发送逻辑，避免在连接未建立或已关闭时发送；3. 核实发送的消息格式是否符合服务器要求（如 JSON 格式）；4. 处理发送失败后的重发机制，确保消息可达

网站页面缓存导致更新内容无法显示

1. 检查页面缓存配置（如 Cache-Control、Expires 头），调整缓存时长；2. 修复静态资源（CSS、JS、图片）的版本控制（如添加版本号？v=1.0）；3. 启用动态内容不缓存策略，确保实时获取最新数据；4. 提供强制刷新入口（如 Ctrl+F5），清除浏览器缓存

网站图表数据 tooltip 显示异常

1. 检查 tooltip 配置是否正确，字段映射是否准确；2. 修复 tooltip 样式，确保不被遮挡且显示完整；3. 处理大数据量时的 tooltip 延迟问题，优化渲染；4. 确保 tooltip 触发条件正确（如 hover、click）

网站导入 CSV 文件数据错误

1. 检查 CSV 文件分隔符是否正确，与设置一致；2. 核实文件编码，避免乱码；3. 修复数据校验逻辑，过滤错误数据；4. 显示错误数据行号和原因，方便用户修改

网站在 5G 网络下加载仍缓慢

1. 检查服务器响应时间，优化后端性能；2. 压缩资源文件，减少数据传输量；3. 修复资源加载阻塞问题，并行加载；4. 确保 CDN 节点在 5G 网络下正常工作