谷歌优化教程详解

网站页面打印时背景色不显示

1. 检查打印样式（print.css）是否设置了 background: transparent；2. 修复打印配置，添加 - webkit-print-color-adjust: exact 属性；3. 核实浏览器打印设置中是否启用 “打印背景图像”；4. 提供 “打印友好版” 页面，优化背景色展示逻辑

网站图表导出图片失败

1. 检查图表导出插件是否正确加载；2. 核实导出图片格式 / 尺寸设置是否正确；3. 修复图片保存逻辑，确保权限足够；4. 处理大图表导出卡顿问题，优化性能

网站面包屑导航缺失部分层级

1. 检查面包屑数据来源，是否正确获取页面的完整层级关系；2. 修复路由配置中的元信息（meta），确保层级字段完整；3. 核实动态路由参数是否正确传递，无层级丢失；4. 手动补充缺失层级的链接和名称，排查数据查询问题

网站表单文件上传进度不显示

1. 检查上传进度监听逻辑是否正确；2. 修复进度条渲染，确保百分比准确；3. 确保上传接口支持分片上传，返回进度；4. 测试不同文件大小，确保进度更新流畅

Nginx 作为反向代理时无法转发请求

1. 检查 Nginx 的 proxy_pass 配置是否正确指向后端服务；2. 核实后端服务是否正常运行，端口是否可通；3. 查看 Nginx 错误日志，排查权限或网络问题；4. 调整 proxy_connect_timeout 等超时参数

网站 WebSocket 消息发送失败

1. 检查 WebSocket 连接状态，是否处于 OPEN 状态（readyState=1）；2. 修复消息发送逻辑，避免在连接未建立或已关闭时发送；3. 核实发送的消息格式是否符合服务器要求（如 JSON 格式）；4. 处理发送失败后的重发机制，确保消息可达

网站 WebSocket 接收消息乱码

1. 检查消息编码格式，确保前后端一致（如 UTF-8）；2. 修复消息解码逻辑，避免二进制数据与文本数据混淆；3. 核实服务器发送的消息是否正确序列化；4. 处理特殊字符转义，避免解码错误

网站订单物流信息无法查询或更新

1. 检查物流接口是否正常调用，API 密钥是否有效；2. 核实物流单号是否正确关联订单，无匹配错误；3. 修复物流信息同步逻辑，增加定时拉取任务；4. 处理物流接口返回异常，提供手动查询入口