班级优化大师学生版教程

网站面包屑导航缺失部分层级

1. 检查面包屑数据来源，是否正确获取页面的完整层级关系；2. 修复路由配置中的元信息（meta），确保层级字段完整；3. 核实动态路由参数是否正确传递，无层级丢失；4. 手动补充缺失层级的链接和名称，排查数据查询问题

网站文件上传进度条不更新

1. 检查 XMLHttpRequest 的 progress 事件监听是否正确；2. 修复进度计算逻辑，确保百分比准确（loaded/total）；3. 核实服务器是否返回 Content-Length 头，便于计算进度；4. 处理大文件分片上传时的进度累加逻辑

网站视频播放进度条无法拖动

1. 检查视频流媒体配置是否支持断点续传；2. 修复进度条事件监听逻辑；3. 确保视频文件格式支持 seek 操作；4. 测试不同浏览器，排查兼容性问题

网站复选框选中后提交，后端未接收到值

1. 检查复选框的 name 属性是否正确，无拼写错误；2. 修复表单序列化逻辑，确保选中的复选框值被正确传递；3. 核实后端接口是否支持数组参数（如 name="hobby []"）；4. 测试单个复选框选中提交，排查多个复选框冲突问题

网站显示 “504 Gateway Timeout” 错误

1. 调整 Nginx 的 fastcgi_connect_timeout、fastcgi_read_timeout 参数；2. 排查 PHP 层资源不足问题，扩容服务器或优化代码；3. 检查数据库连接数是否达到上限，调整连接池配置；4. 优化耗时操作（如外部接口调用、大数据查询）

网站数据库优化失败，性能未提升

1. 检查优化脚本是否正确执行；2. 核实数据库索引是否建立成功；3. 修复表碎片，优化表结构；4. 分析慢查询日志，针对性优化

网站 WebSocket 消息推送延迟

1. 检查 WebSocket 连接是否稳定，有无断线重连；2. 优化消息发送逻辑，避免消息堆积；3. 增加消息优先级，确保重要消息优先推送；4. 扩容 WebSocket 服务，提升并发处理能力

网站 RSS 订阅功能失效

1. 检查 RSS feed 生成代码，确保 XML 格式正确；2. 核实 RSS 地址是否可访问，无权限限制；3. 定期更新 RSS 内容，确保时效性；4. 测试 RSS 订阅工具（如 Feedly），排查兼容性

网站视频画中画功能失效

1. 检查浏览器是否支持画中画 API；2. 修复画中画按钮事件逻辑；3. 确保视频元素满足画中画要求；4. 处理画中画切换时的状态保存