仓储优化的目的

服务器网卡流量过高，网络拥堵

1. 用 iftop 命令查看流量占用情况，排查是否有 DDoS 攻击；2. 限制非必要端口的网络访问，开启防火墙防护；3. 采用 CDN 分流静态资源流量，减轻源站压力；4. 升级服务器带宽，或配置流量整形策略

网站后台主题无法切换

1. 检查主题是否正确安装，文件是否完整；2. 核实主题切换逻辑，是否正确保存设置；3. 修复主题渲染逻辑，避免样式冲突；4. 测试不同主题，排查兼容性问题

网站 API 网关路由失败

1. 检查网关服务（如 Spring Cloud Gateway）是否正常运行；2. 核实路由配置是否正确，路径是否匹配；3. 修复网关过滤器逻辑，避免拦截正常请求；4. 查看网关日志，排查错误原因

网站 OCR 识别无法提取文字或提取错误

1. 确保图片清晰、文字对比度高，无遮挡；2. 调整图片尺寸，符合 OCR 接口要求（如最小分辨率）；3. 选择支持对应语言的 OCR 接口；4. 处理倾斜图片，先进行旋转校正再识别

网站 cookie 设置后跨域无法读取

1. 检查 cookie 的 domain 配置，是否允许跨域子域名访问；2. 修复 cookie 的 SameSite 属性，设置为 Lax 或 None（需配合 Secure 属性）；3. 核实跨域场景是否支持 cookie 传递（如前后端分离项目需特殊配置）；4. 改用 token 存储替代 cookie，规避跨域限制

网站数据库恢复失败

1. 检查备份文件是否完整，无损坏；2. 核实数据库版本是否与备份文件兼容；3. 修复恢复脚本，确保数据正确导入；4. 关闭数据库写入操作，避免恢复时数据冲突

网站 Elasticsearch 搜索无法使用

1. 检查 Elasticsearch 服务是否正常启动；2. 核实索引是否创建成功，数据是否同步；3. 修复搜索查询语法，避免错误；4. 查看 Elasticsearch 日志，排查错误原因

网站服务器带宽不足，高峰期卡顿

1. 联系服务商升级带宽，提升网络传输能力；2. 用 CDN 分流静态资源，减少源站带宽占用；3. 压缩网站资源，降低数据传输量；4. 限制非必要带宽消耗（如大文件下载、视频播放）

网站页面打印时格式错乱，部分内容缺失

1. 检查打印样式（print.css）是否配置，是否隐藏不必要元素；2. 修复打印布局，确保内容适应纸张大小（如 A4）；3. 核实打印时的图片、表格是否完整渲染；4. 提供 “打印友好版” 页面，优化打印格式