班级优化大师功能介绍

网站 PWA 应用无法接收推送通知，提示 “权限被拒”

1. 检查用户是否已拒绝通知权限，引导在浏览器设置中重新开启；2. 修复推送权限申请逻辑，确保在用户交互后触发（如点击按钮）；3. 核实浏览器是否支持 Push API（如部分国产浏览器不支持）；4. 提供权限申请引导页面，告知用户开启通知的步骤

网站留言板提交留言后不显示

1. 检查留言提交接口是否正确存储留言数据，无入库失败；2. 修复留言审核逻辑，是否启用人工审核（未审核留言不显示）；3. 核实留言是否包含敏感词被屏蔽；4. 查看留言日志，排查提交失败原因（如字段为空）

网站 PDF 文件在线预览乱码

1. 确保 PDF 文件编码正确，无损坏；2. 修复 PDF.js 配置，确保字体支持；3. 核实 PDF 文件路径是否正确，无中文乱码；4. 测试不同大小的 PDF 文件，确保预览流畅

网站管理员无法导入数据

1. 检查导入文件格式是否符合要求；2. 核实导入数据校验逻辑，是否过滤错误数据；3. 修复导入接口，确保数据正确写入数据库；4. 显示导入进度和错误提示，方便排查

网站验证码输入后提示 “验证码错误” 但输入正确

1. 检查验证码大小写是否敏感，无大小写不匹配；2. 修复验证码 session 存储，确保与当前用户会话一致；3. 核实验证码是否已过期（如有效期 5 分钟）；4. 刷新验证码后重新输入，避免缓存导致的错误

网站在线客服聊天记录无法查看

1. 检查聊天记录存储逻辑，是否正确保存对话内容；2. 修复聊天记录查询接口，确保按用户 ID、时间范围查询生效；3. 核实客服是否有查看聊天记录的权限；4. 处理历史聊天记录分页加载，避免数据量过大导致卡顿

网站标签页切换时内容不刷新或错乱

1. 检查标签页切换事件是否正确绑定，切换时触发内容加载；2. 修复标签页对应的内容容器显示 / 隐藏逻辑；3. 确保每个标签页的请求参数独立，不相互覆盖；4. 处理标签页缓存逻辑，根据需求选择是否刷新数据

网站商品详情页图片无法放大查看

1. 检查图片放大插件是否正确加载，依赖的 JS/CSS 是否完整；2. 修复放大功能事件绑定，确保点击图片触发放大；3. 核实商品详情图是否上传高清版本，避免放大后模糊；4. 处理移动端图片放大的触摸手势兼容（如双指缩放）

网站音频无法自动播放，即使添加 autoplay 属性

1. 检查浏览器是否支持自动播放，部分浏览器要求静音自动播放（添加 muted 属性）；2. 修复自动播放触发逻辑，确保在用户交互后执行（如页面加载完成后）；3. 核实音频文件是否加载完成，未加载完成无法自动播放；4. 提供手动播放按钮，作为自动播放的备选