班级优化大师安装后弹出

网站 Word 文件在线预览格式错乱

1. 检查 Docx.js 等预览插件是否正确加载；2. 修复 Word 文件格式解析逻辑，支持复杂格式；3. 确保图片、表格等元素正确显示；4. 处理大文件预览卡顿问题，分页加载

网站跨域请求返回 “Access-Control-Allow-Headers 不允许”

1. 后端响应头添加 Access-Control-Allow-Headers，包含前端自定义头（如 Token、Content-Type）；2. 修复前端 AJAX 请求的自定义头参数，确保在允许列表中；3. 核实预检请求（OPTIONS）是否正确响应允许的头信息；4. 简化自定义头，使用标准头信息避免跨域限制

网站日期选择器月份切换时日期错误

1. 检查日期选择器插件的月份切换逻辑，是否正确计算月份天数（如 2 月、30 天 / 31 天月份）；2. 修复日期格式转换，避免月份切换后日期溢出（如 3 月 31 日切换到 4 月，自动调整为 4 月 30 日）；3. 核实插件版本是否存在已知 bug，升级到稳定版本；4. 测试边界日期（如 1 月 1 日、12 月 31 日）的切换效果

网站分页控件点击 “下一页” 无响应，页码不变化

1. 检查下一页按钮的事件绑定，是否正确更新页码参数；2. 修复分页查询的页码计算逻辑，确保当前页码 + 1 有效；3. 核实是否已到达最后一页，下一页按钮被禁用；4. 检查分页控件的 DOM 结构，无被其他元素遮挡点击

网站静态资源缓存失效，重复加载

1. 设置合理的 Cache-Control 和 Expires 头，延长缓存时间；2. 对静态资源添加版本号（如 style.v2.css），更新时刷新缓存；3. 确保 CDN 节点缓存配置与源站一致；4. 避免频繁修改静态资源文件名，保持缓存有效性

网站本地存储（localStorage/sessionStorage）数据丢失

1. 检查存储数据的大小是否超过限制（localStorage 默认 5MB）；2. 核实存储的键名是否重复，避免被覆盖；3. 处理浏览器隐私模式下的存储限制，提供 cookie 备选；4. 确保存储数据格式正确（如 JSON.stringify 序列化）

网站大文件下载中断或速度极慢

1. 启用 HTTP 分块传输（Chunked Transfer Encoding）；2. 采用断点续传技术，支持中断后继续下载；3. 利用 CDN 加速大文件分发，减少源站压力；4. 优化服务器磁盘 IO 和网络带宽，提升传输速度

网站页面提示 “404 Not Found”

1. 确认访问的 URL 是否正确，检查链接是否失效；2. 核实静态页面 / PHP 文件是否被误删或移动；3. 检查 Web 服务器的网站根目录配置是否正确；4. 配置 404 跳转页面，优化用户体验

网站在 5G 网络下加载仍缓慢

1. 检查服务器响应时间，优化后端性能；2. 压缩资源文件，减少数据传输量；3. 修复资源加载阻塞问题，并行加载；4. 确保 CDN 节点在 5G 网络下正常工作