课堂教学优化原则

网站积分商城积分兑换记录查询不到

1. 检查兑换记录查询接口的时间范围参数是否正确；2. 修复兑换记录存储逻辑，确保记录完整入库；3. 核实用户 ID 与兑换记录的关联是否正确，无匹配错误；4. 调整查询条件（如模糊查询、全量查询），排查筛选条件过严

网站图片懒加载时图片加载失败，重试后仍失败

1. 检查图片 URL 是否正确，无拼写错误或失效；2. 修复懒加载插件的重试机制，增加重试次数；3. 核实服务器是否存在图片文件损坏，重新上传图片；4. 替换为备用图片 URL，确保页面正常显示

网站验证码无法刷新，无法识别

1. 检查验证码生成接口是否正常，是否返回图片；2. 核实验证码刷新逻辑，是否正确更换验证码；3. 优化验证码清晰度，避免模糊难以识别；4. 增加语音验证码选项，提供替代方案

网站下载文件时浏览器自动打开而非下载

1. 修复 Web 服务器的 Content-Disposition 响应头，设置为 attachment；2. 确保正确设置文件的 MIME 类型（如 application/octet-stream）；3. 检查文件后缀名是否与 MIME 类型匹配；4. 前端添加 download 属性到下载链接（）

网站页面 URL 带 #号导致无法分享或跳转异常

1. 检查 URL 路由模式，是否使用 hash 模式（# 后内容不发送到服务器）；2. 切换为 history 模式，配置服务器 Rewrite 规则（如 Nginx 配置 try_files）；3. 处理分享链接时的 URL 拼接，确保 #后参数正确传递；4. 测试跳转逻辑，确保 hash 值变化时页面正确响应

网站在平板设备上布局错乱

1. 优化响应式布局，添加平板设备媒体查询（768px-1024px）；2. 调整元素尺寸和间距，适配平板屏幕；3. 确保触摸目标尺寸足够（不小于 48px）；4. 测试横屏 / 竖屏切换，布局自动调整

网站问卷调查必填项未填写仍可提交

1. 检查前端表单验证逻辑，确保必填项（required）校验生效；2. 修复后端参数校验，拒绝必填项为空的提交请求；3. 核实表单提交按钮是否绑定了验证函数，无跳过验证；4. 给必填项添加明显标识（如 *），提示用户必须填写

网站会员等级权益未生效

1. 检查会员等级判断逻辑，是否正确读取用户等级；2. 核实权益配置是否与会员等级关联，无配置错误；3. 修复会员等级更新后未同步权益的问题；4. 提供会员权益说明，明确使用条件

网站滑块验证码拖动到终点仍提示 “验证失败”

1. 检查滑块偏移量计算，是否与后端校验的阈值偏差过大；2. 修复滑块拖动事件，确保准确获取终点坐标；3. 核实是否存在浏览器缩放，导致坐标计算错误；4. 重置浏览器缩放比例（100%），重新尝试验证