班级优化大师使用心得 学生篇

网站表单下拉框多选功能无法保存选中值

1. 检查表单提交时是否正确序列化多选值（如数组格式）；2. 修复后端接收逻辑，确保支持数组参数解析；3. 确保下拉框的 name 属性添加 [] 标识（如 name="tags []"）；4. 测试编辑页面，确保选中值正确回显

网站 API 网关路由失败

1. 检查网关服务（如 Spring Cloud Gateway）是否正常运行；2. 核实路由配置是否正确，路径是否匹配；3. 修复网关过滤器逻辑，避免拦截正常请求；4. 查看网关日志，排查错误原因

网站 PDF 文件在线预览乱码

1. 确保 PDF 文件编码正确，无损坏；2. 修复 PDF.js 配置，确保字体支持；3. 核实 PDF 文件路径是否正确，无中文乱码；4. 测试不同大小的 PDF 文件，确保预览流畅

网站 PWA 添加到主屏幕后图标显示异常

1. 检查 manifest.json 中 icons 配置，确保尺寸和路径正确；2. 确保图标格式为 PNG，背景为纯色；3. 修复 manifest.json 格式错误，确保符合标准；4. 测试不同 iOS/Android 设备，确保兼容

网站表格合并单元格后排序 / 筛选失效

1. 修复排序 / 筛选算法，确保正确识别合并单元格的数据；2. 避免合并关键数据列，只合并展示性列（如备注）；3. 排序 / 筛选时临时取消合并，排序完成后重新合并；4. 提示用户合并单元格后排序可能影响结果，建议先取消合并

网站登录功能失效，无法登录

1. 检查登录表单提交地址是否正确，接口是否正常；2. 核实账号密码是否正确，是否区分大小写；3. 查看登录日志，排查账号锁定或异常登录；4. 清除浏览器 cookie，测试重新登录

网站微信分享功能无法自定义标题 / 图片

1. 检查微信 JSSDK 配置是否正确（appId、timestamp、nonceStr、signature）；2. 核实分享接口（onMenuShareAppMessage 等）是否正确注册；3. 确保分享的图片尺寸符合要求（建议 300x300px）；4. 排查页面是否有脚本错误，导致 JSSDK 初始化失败

网站 WebSocket 消息推送延迟

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

网站上拉加载更多后页面滚动到顶部

1. 检查上拉加载的 DOM 渲染逻辑，是否导致页面滚动偏移；2. 修复加载后的滚动位置保持，记录加载前的滚动距离；3. 核实是否有脚本强制设置 scrollTop 为 0；4. 优化加载动画位置，避免影响滚动