班级优化大师软件使用方法

网站优惠券领取失败，提示 “已达领取上限”

1. 检查优惠券领取限制配置（如每人限领 1 张、总量有限）；2. 核实用户是否已领取该优惠券，避免重复领取；3. 修复领取数量统计逻辑，确保计数准确；4. 明确提示领取上限及用户当前领取次数

网站在 Firefox 浏览器显示异常

1. 检查 CSS 兼容性，使用前缀（-moz-）适配 Firefox；2. 避免使用浏览器专属属性，采用标准 HTML/CSS；3. 用 Firefox 开发者工具排查布局问题；4. 测试不同 Firefox 版本，确保兼容主流版本

网站键盘导航无法操作

1. 确保所有可交互元素（按钮、链接）支持键盘聚焦；2. 修复 tab 键导航顺序，按逻辑顺序排列；3. 支持 Enter/Space 键触发点击事件；4. 显示键盘焦点样式，提升可操作性

网站后台无法上传文件

1. 检查文件上传大小限制（php.ini upload_max_filesize）；2. 核实上传目录权限，确保有写入权限；3. 修复文件类型过滤逻辑，避免合法文件被拦截；4. 查看上传日志，排查接口错误或网络问题

网站表单复选框无法选中

1. 检查复选框 input 元素 type 是否为 checkbox；2. 修复选中事件逻辑，确保状态正确切换；3. 确保复选框无样式遮挡，可点击；4. 测试不同浏览器，排查兼容性

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

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

网站苹果触摸图标（apple-touch-icon）无法显示

1. 准备不同尺寸的苹果触摸图标（180x180 等）；2. 放置图标到网站根目录，或通过 link 标签指定路径；3. 确保图标格式为 PNG，无透明度；4. 测试 iOS 设备添加到主屏幕的效果

网站 WebSocket 连接失败，实时功能失效

1. 检查 WebSocket 服务是否正常启动，端口是否开放；2. 核实连接 URL 是否正确（ws:///wss://）；3. 修复防火墙规则，允许 WebSocket 连接；4. 增加重连机制，处理连接断开情况

网站放大镜功能失效，无法查看图片细节

1. 检查放大镜插件是否正确加载，配置是否正确；2. 核实图片路径是否正确，原图是否存在；3. 修复鼠标事件监听逻辑，确保触发放大镜；4. 测试不同图片尺寸，确保适配放大镜功能