优化师资队伍结构标题

网站 API 接口版本冲突

1. 检查接口版本号是否正确，是否支持目标版本；2. 核实请求头中版本参数是否正确传递；3. 提供接口版本兼容方案，避免强制升级；4. 文档中明确版本差异，指导用户适配

网站表格筛选功能失效

1. 检查筛选条件输入是否正确；2. 修复筛选逻辑，确保数据正确过滤；3. 确保筛选状态正确保存，分页时不丢失；4. 处理多条件筛选，确保逻辑正确

网站 CSS 样式不生效，显示默认样式

1. 检查 CSS 文件路径是否正确，是否加载成功；2. 修复 CSS 语法错误（如括号不闭合、属性拼写错误）；3. 确保 CSS 选择器正确匹配 HTML 元素；4. 清除浏览器缓存，测试最新样式

网站积分商城积分兑换记录查询不到

1. 检查兑换记录查询接口的时间范围参数是否正确；2. 修复兑换记录存储逻辑，确保记录完整入库；3. 核实用户 ID 与兑换记录的关联是否正确，无匹配错误；4. 调整查询条件（如模糊查询、全量查询），排查筛选条件过严

网站页面滚动时元素错位或抖动

1. 检查 CSS 定位属性（如 position: fixed）是否正确，避免滚动时偏移；2. 修复滚动事件监听逻辑，避免频繁修改 DOM 导致回流；3. 确保元素宽高固定，或使用 flex/grid 布局适配滚动；4. 处理移动端滚动穿透问题，避免弹窗滚动影响背景

网站 Redis 缓存数据不一致

1. 优化缓存更新策略，确保数据同步；2. 设置合理的缓存过期时间；3. 采用缓存穿透 / 击穿 / 雪崩防护措施；4. 定期校验缓存与数据库数据，修复不一致

网站 PWA 应用无法安装或安装后无法打开

1. 检查 manifest.json 文件格式是否正确，必填字段（name、short_name、start_url、icons）是否完整；2. 确保 Service Worker 正确注册并激活；3. 核实网站已部署 HTTPS，且无混合内容；4. 测试不同设备（iOS/Android）的安装流程，排查兼容性

网站分页控件点击页码无响应

1. 检查分页控件的点击事件绑定是否正确；2. 修复页码参数传递逻辑，确保正确拼接 URL 或请求体；3. 确保分页控件的 DOM 结构未被其他元素遮挡；4. 测试边界页码（如首页、尾页）的跳转逻辑

网站用户评价无法上传图片

1. 检查评价图片上传接口配置是否正确，上传目录是否有写入权限；2. 修复图片大小 / 格式限制逻辑（如是否允许 png/jpg，单张不超过 5MB）；3. 核实图片上传数量是否超出限制（如最多上传 5 张）；4. 处理网络异常导致的上传失败，提供重新上传入口