道路路段交通优化

网站 API 网关路由失败

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

网站 OCR 识别文字重复或缺失

1. 检查图片清晰度，确保文字无模糊、遮挡；2. 修复 OCR 接口的识别参数，调整识别精度；3. 核实图片是否倾斜，先进行校正再识别；4. 处理识别结果后处理，去重或补全缺失文字

网站 Cookie 无法设置或读取

1. 检查 Cookie 设置参数（domain、path、expires）是否正确；2. 确保 Cookie 大小不超过 4KB；3. 修复浏览器禁用 Cookie 的提示，引导用户启用；4. 对重要数据，避免依赖 Cookie，采用 localStorage

域名无法解析，网站打不开

1. 更换公共 DNS 服务器（谷歌 8.8.8.8，阿里云 223.5.5.5）；2. 清除本地 DNS 缓存（Windows 用 ipconfig /flushdns，Linux 用 systemd-resolve --flush-caches）；3. 登录域名管理界面，检查 A/CNAME 记录是否指向正确 IP；4. 联系域名注册商，确认域名是否过期或解析异常

网站后台数据筛选后分页控件失效

1. 检查筛选参数与分页参数的拼接逻辑，确保分页请求携带筛选条件；2. 修复分页查询语句，确保基于筛选结果计算总页数；3. 核实筛选后的总记录数统计是否正确；4. 刷新页面后重新执行筛选 + 分页操作，排查临时缓存问题

网站用户注册功能异常，无法注册

1. 检查注册表单验证逻辑，是否误判合法输入；2. 核实用户数据是否正确写入数据库；3. 修复用户名 / 手机号重复校验逻辑；4. 处理注册接口报错，显示明确提示

网站支付宝支付后回调页面无法访问

1. 检查回调地址是否公网可访问，无防火墙拦截；2. 核实回调地址是否正确配置在支付宝商户平台；3. 修复回调接口的权限校验，确保仅支付宝服务器可访问；4. 处理回调参数的签名验证，避免伪造回调

网站 WebSocket 连接失败，实时功能失效

1. 检查 WebSocket 服务是否正常启动，端口是否开放；2. 核实连接 URL 是否正确（ws:///wss://）；3. 修复防火墙规则，允许 WebSocket 连接；4. 增加重连机制，处理连接断开情况

网站二维码生成失败

1. 检查二维码生成接口是否正常；2. 核实生成参数（内容、尺寸、容错级别）是否正确；3. 修复二维码图片保存 / 输出逻辑；4. 测试不同内容长度，确保生成成功