优化服务平台支撑

网站 API 网关路由失败

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

Web 服务器配置文件错误导致服务无法启动

1. 检查配置文件语法（Nginx 用 nginx -t，Apache 用 apachectl configtest）；2. 核实虚拟主机配置中的端口、根目录、日志路径是否正确；3. 注释新增配置，逐步排查错误配置项；4. 恢复之前的正确配置文件，重新启动服务

网站下拉框选项搜索无结果或搜索缓慢

1. 修复搜索逻辑，确保关键词匹配准确（支持模糊查询）；2. 优化搜索算法，减少查询耗时；3. 实现输入防抖，避免输入过快导致的频繁查询；4. 处理无结果时的提示，引导用户调整关键词

网站表格导出 Excel 时中文文件名乱码

1. 检查文件名编码格式，采用 UTF-8 编码并进行 URL 编码；2. 修复后端响应头的 Content-Disposition 配置，正确设置文件名；3. 核实浏览器是否支持中文文件名，必要时使用拼音或英文命名；4. 测试不同浏览器的下载效果，确保文件名正常显示

网站模态框打开后背景滚动无法禁止

1. 打开模态框时给 body 添加 overflow: hidden 样式；2. 修复移动端触摸事件，禁止背景滚动；3. 确保模态框关闭时移除禁止滚动样式；4. 处理 iOS 系统的弹性滚动问题，添加额外兼容代码

网站图表无法显示或加载失败

1. 检查图表插件是否正确加载，依赖的 JS 库（如 Chart.js、ECharts）是否完整；2. 核实图表数据格式是否正确，与插件要求一致；3. 确保图表容器有明确的宽高，避免无法渲染；4. 查看浏览器控制台，排查脚本错误或数据为空

网站 WebSocket 消息发送失败

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

网站 AJAX 请求返回 401 未授权错误

1. 检查用户登录状态是否过期，引导重新登录；2. 核实请求头中的 Token 是否正确传递，未失效；3. 修复后端权限校验逻辑，确保接口权限配置正确；4. 处理 Token 过期后的自动刷新逻辑

网站投票功能投票后票数未增加

1. 检查投票接口的防刷票逻辑，是否限制同一用户重复投票；2. 修复票数统计逻辑，确保投票成功后实时累加；3. 核实投票是否在有效期内，未过期；4. 处理投票失败提示（如 “您已投票”“投票已结束”）