网站优化建议书

网站 OCR 识别功能失效

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

网站页面在 Firefox 浏览器 JavaScript 报错

1. 检查 JS 代码是否使用了 Firefox 不支持的 API 或语法；2. 修复控制台报错提示的具体代码行，替换兼容写法；3. 核实 Firefox 浏览器版本，是否为旧版本不支持新特性；4. 启用 Firefox 的兼容模式测试，排查兼容性问题

网站数据库备份失败

1. 检查备份路径权限，是否有写入权限；2. 核实数据库连接是否正常；3. 修复备份脚本，确保所有表都被备份；4. 处理大数据备份超时问题，分表备份

网站 CDN 加速未生效，静态资源加载慢

1. 检查 CDN 配置是否正确，源站地址是否无误；2. 核实域名解析是否指向 CDN 节点，而非源站 IP；3. 清除 CDN 缓存，确保最新资源生效；4. 测试 CDN 节点连通性，更换故障节点

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

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

网站用户注册功能异常，无法注册

1. 检查注册表单验证逻辑，是否误判合法输入；2. 核实用户数据是否正确写入数据库；3. 修复用户名 / 手机号重复校验逻辑；4. 处理注册接口报错，显示明确提示

网站视频无法播放，加载失败

1. 检查视频格式是否兼容（推荐 MP4，支持多数浏览器）；2. 核实视频文件路径是否正确，文件是否完整；3. 采用视频点播服务（如阿里云视频），提升播放稳定性；4. 调整视频码率，适配不同网络速度

网站消息队列消费失败

1. 检查消费者服务是否正常运行；2. 核实消费逻辑是否正确，无业务错误；3. 修复消息重试机制，处理失败消息；4. 监控队列堆积情况，及时扩容

网站表单多步骤提交时，步骤切换后数据丢失

1. 检查步骤间数据存储逻辑，是否使用 localStorage/sessionStorage 暂存；2. 修复数据传递逻辑，确保步骤切换时数据不被覆盖；3. 核实是否启用表单数据自动保存，避免刷新页面丢失；4. 步骤切换前提示用户保存数据，确认后再切换