谷歌引擎优化

网站离线缓存不生效，无法离线访问

1. 检查 Service Worker 注册是否成功，是否缓存资源；2. 修复缓存策略，确保关键资源被缓存；3. 清除旧的 Service Worker，更新缓存；4. 测试离线状态下的页面加载，确保功能正常

网站 OCR 识别功能失效

1. 检查 OCR 接口是否正常，配置是否正确；2. 核实图片是否清晰，符合识别要求；3. 修复图片上传逻辑，确保格式 / 尺寸正确；4. 处理识别错误，提供手动输入备选

网站视频全屏播放失效

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

网站表单提交时出现 “字段格式错误” 但未提示具体字段

1. 修复前端表单验证逻辑，明确提示错误字段（如 “手机号格式错误”）；2. 后端返回错误信息时携带字段名，便于前端定位；3. 给错误字段添加高亮样式，直观提示用户；4. 优化验证提示位置，靠近对应字段

网站验证码刷新后无法点击或验证失败

1. 检查验证码图片生成接口是否正常返回新图片；2. 修复刷新按钮的事件绑定，确保触发重新请求；3. 核实验证码存储的 session 是否与当前用户匹配；4. 优化验证码识别难度，避免过度复杂导致用户误输

网站图片懒加载时出现闪烁

1. 检查图片容器是否设置了占位图或固定宽高，避免加载后布局偏移；2. 修复懒加载插件的加载时机，确保图片进入可视区域前开始加载；3. 核实图片是否启用了渐进式加载；4. 优化图片格式（如 WebP），减少加载时间

网站地图标注位置错误

1. 检查地图标注的经纬度是否正确，无输入错误；2. 修复标注位置调整逻辑，允许手动拖动标注；3. 核实地图缩放级别是否合适，标注是否在可视范围内；4. 更换地图数据源，确保地理位置匹配准确

网站 PWA 应用更新后无法加载新版本

1. 检查 Service Worker 的更新逻辑，是否监听了 controllerchange 事件；2. 修复 Service Worker 缓存策略，确保新版本资源优先加载；3. 核实 manifest.json 文件的 version 是否更新；4. 提示用户刷新页面，激活新版本

网站分页控件页码显示不全，超出屏幕

1. 检查分页控件的样式配置，是否设置了最大显示页码数（如显示 5 个页码）；2. 修复分页渲染逻辑，超出部分用 “...” 代替，显示首尾页码；3. 调整分页控件宽度，适应不同屏幕尺寸；4. 移动端优化为下拉选择页码，节省空间