优化客户体验

网站 API 网关路由失败

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

网站数据库连接超时或连接池耗尽

1. 检查数据库连接池配置（如最大连接数、超时时间）；2. 修复代码中的连接释放逻辑，避免未关闭连接导致泄漏；3. 优化数据库查询效率，减少连接占用时间；4. 监控数据库连接状态，及时扩容或排查异常连接

网站面包屑导航在动态路由页面显示错误

1. 检查面包屑数据是否从路由元信息中正确获取；2. 修复动态路由参数解析，确保面包屑名称正确显示；3. 核实是否存在路由匹配错误，导致面包屑关联错误页面；4. 手动配置动态路由的面包屑规则，确保显示准确

网站被镜像后排名超过原创站点

1. 向搜索引擎提交版权投诉，提供原创证明（如域名注册时间、内容发布时间）；2. 配置 canonical 标签，明确指定原创页面地址；3. 启用网站认证（如百度站点认证），提升原创站点权重；4. 加快内容更新频率，保持原创内容优势

网站 PDF 文件在线预览乱码

1. 确保 PDF 文件编码正确，无损坏；2. 修复 PDF.js 配置，确保字体支持；3. 核实 PDF 文件路径是否正确，无中文乱码；4. 测试不同大小的 PDF 文件，确保预览流畅

网站实时聊天消息发送后对方接收不到

1. 检查 WebSocket 消息推送逻辑，是否正确发送给目标用户；2. 修复用户在线状态判断，确保对方处于在线状态；3. 核实消息队列是否存在消息堆积，未及时推送；4. 提供消息送达回执，确认对方是否已接收

网站标签页切换时内容不刷新或错乱

1. 检查标签页切换事件是否正确绑定，切换时触发内容加载；2. 修复标签页对应的内容容器显示 / 隐藏逻辑；3. 确保每个标签页的请求参数独立，不相互覆盖；4. 处理标签页缓存逻辑，根据需求选择是否刷新数据

网站用户评价无法上传图片

1. 检查评价图片上传接口配置是否正确，上传目录是否有写入权限；2. 修复图片大小 / 格式限制逻辑（如是否允许 png/jpg，单张不超过 5MB）；3. 核实图片上传数量是否超出限制（如最多上传 5 张）；4. 处理网络异常导致的上传失败，提供重新上传入口

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

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