班级优化大师pc端使用指南

网站 localStorage 存储数据后无法读取

1. 检查存储的键名是否正确，无拼写错误或大小写不一致；2. 修复数据读取逻辑，确保正确反序列化（如 JSON.parse）；3. 核实浏览器是否开启隐私模式（隐私模式下 localStorage 可能受限）；4. 检查存储数据大小是否超过限制，清理无用数据

网站视频全屏播放失效

1. 检查全屏 API 是否被浏览器支持；2. 修复全屏事件监听逻辑，处理浏览器差异；3. 确保视频容器没有层级遮挡；4. 测试不同浏览器全屏功能，统一优化

网站分页功能异常，无法翻页

1. 检查分页参数传递是否正确（如 page、limit）；2. 核实后端分页查询逻辑，是否正确计算总页数；3. 修复分页链接跳转地址，确保指向正确页面；4. 测试边界情况（第一页、最后一页、超出范围）

网站第三方登录后用户信息与本地账号不一致

1. 检查用户信息同步逻辑，是否将第三方信息更新到本地账号；2. 修复信息匹配规则（如按手机号、邮箱关联）；3. 核实是否允许用户手动修改同步后的信息；4. 显示信息同步结果，让用户确认是否更新

网站留言板出现垃圾评论

1. 启用验证码功能，防止机器人提交；2. 配置关键词过滤，屏蔽垃圾评论内容；3. 采用人工审核机制，审核通过后显示；4. 限制同一 IP 提交频率，避免批量刷评论

网站 cookie 被浏览器自动清除

1. 检查 cookie 的 expires/max-age 设置，是否未设置过期时间（会话级 cookie）；2. 修复 cookie 的 domain 和 path 配置，确保与当前页面匹配；3. 核实浏览器是否开启了自动清理 cookie 功能；4. 改用持久化 cookie（设置合理过期时间），避免会话结束后清除

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

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

网站面包屑导航显示错误的路径

1. 检查面包屑数据来源是否正确，与当前页面 URL 匹配；2. 修复路径拼接逻辑，确保层级关系准确；3. 核实路由配置中的元信息（meta）是否完整；4. 处理动态路由参数，确保路径参数正确显示

操作系统防火墙设置导致网站端口无法访问

1. 检查 iptables/ufw 防火墙规则，开放网站端口（如 80、443）；2. 确认防火墙的 input/output 规则是否阻止了请求 / 响应；3. 临时关闭防火墙测试是否恢复访问，定位问题根源；4. 配置防火墙白名单，仅允许合法 IP 访问