班级优化大师pc端使用手册最新版

网站管理员无法导出数据

1. 检查导出接口是否正常，权限是否足够；2. 核实导出文件格式（Excel/CSV）是否正确；3. 修复导出数据查询逻辑，确保数据完整；4. 处理大数据导出超时问题，分批次导出

网站 API 接口版本冲突

1. 检查接口版本号是否正确，是否支持目标版本；2. 核实请求头中版本参数是否正确传递；3. 提供接口版本兼容方案，避免强制升级；4. 文档中明确版本差异，指导用户适配

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

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

网站表格筛选功能失效

1. 检查筛选条件输入是否正确；2. 修复筛选逻辑，确保数据正确过滤；3. 确保筛选状态正确保存，分页时不丢失；4. 处理多条件筛选，确保逻辑正确

网站短信验证码无法接收

1. 检查短信接口配置（API 密钥、模板 ID）是否正确；2. 核实手机号是否正确，是否被运营商拦截；3. 查看短信发送日志，排查接口错误；4. 提供语音验证码备选方案

网站推送通知功能无法使用

1. 确保网站启用 HTTPS，用户授予通知权限；2. 检查推送服务配置（如 Firebase Cloud Messaging）；3. 修复 Service Worker 推送事件处理逻辑；4. 测试不同浏览器，排查兼容性问题

网站复选框 / 单选框选中状态不保存

1. 检查表单提交时是否正确获取选中状态；2. 修复编辑页面的选中状态回显逻辑；3. 确保复选框 / 单选框的 name 和 value 属性设置正确；4. 处理动态生成的复选框 / 单选框，绑定正确事件

网站在低网络环境下无法加载

1. 优化资源加载优先级，优先加载关键内容；2. 实现懒加载，延迟加载非必要资源；3. 提供离线访问功能，缓存关键资源；4. 显示网络状态提示，引导用户切换网络

网站地图定位功能不准确

1. 检查定位接口（如高德 / 百度地图 API）配置是否正确；2. 核实 IP 定位是否开启，精度是否足够；3. 提供手动调整定位的功能；4. 处理定位失败的情况，显示默认位置