系统优化提升客户体验的方法

网站 OCR 识别功能失效

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

打开网站显示 “400 Bad Request”

1. 检查本地网络是否正常，重启路由器排查断网问题；2. 调整 Web 服务器的 client_header_buffer_size、large_client_header_buffers 参数；3. 核实 WEB 服务器模块是否正常加载（如 Nginx 的 PHP 模块）；4. 重启僵死的 Web 服务器进程

网站出现大量重复内容，影响 SEO

1. 使用 canonical 标签，指定首选页面；2. 合并重复内容页面，设置 301 跳转；3. 优化 URL 结构，避免同一内容多 URL 访问；4. 修复爬虫陷阱（如无限分页、会话 ID 在 URL 中）

网站 AJAX 请求失败，数据无法加载

1. 检查请求 URL 是否正确，接口是否正常；2. 核实请求方法（GET/POST）和参数是否正确；3. 修复跨域问题（CORS 配置），允许跨域请求；4. 查看网络请求日志，排查 404/500 等错误

网站文件在线预览功能失效

1. 检查预览接口是否正常，支持的文件格式是否正确；2. 核实文件路径是否正确，文件是否存在；3. 修复预览插件（如 PDF.js、Docx.js）加载逻辑；4. 处理不支持的文件格式，提示用户下载

网站大文件下载时进度条不更新

1. 检查 XMLHttpRequest 的 progress 事件监听是否正确；2. 修复进度计算逻辑，确保 loaded 和 total 参数获取准确；3. 核实服务器是否返回 Content-Length 头，无该头无法计算进度；4. 处理分块下载时的进度累加，确保总进度正确

网站模态框打开后键盘无法操作输入框

1. 检查模态框是否设置了 tabindex 属性，确保可聚焦；2. 修复键盘事件监听，避免被其他脚本阻止；3. 核实输入框是否被禁用或只读，无操作权限；4. 刷新模态框，重新渲染输入框，排查 DOM 结构问题

网站 PWA 应用离线无法访问

1. 检查 Service Worker 是否缓存了核心资源（HTML、CSS、JS、图片）；2. 修复缓存策略，确保关键资源被正确缓存；3. 核实离线页面是否配置正确，可被 Service Worker 拦截返回；4. 清除旧的 Service Worker 缓存，更新为最新版本

网站消息队列（MQ）无法发送消息

1. 检查 MQ 服务（如 RabbitMQ、Kafka）是否正常启动；2. 核实队列是否创建成功，权限是否足够；3. 修复消息发送逻辑，确保参数正确；4. 查看 MQ 日志，排查错误原因