道路交通组织优化方案

网站 API 接口版本冲突

1. 检查接口版本号是否正确，是否支持目标版本；2. 核实请求头中版本参数是否正确传递；3. 提供接口版本兼容方案，避免强制升级；4. 文档中明确版本差异，指导用户适配

网站 Word 文件在线预览格式错乱

1. 检查 Docx.js 等预览插件是否正确加载；2. 修复 Word 文件格式解析逻辑，支持复杂格式；3. 确保图片、表格等元素正确显示；4. 处理大文件预览卡顿问题，分页加载

网站图片加载完成后出现白边或边框

1. 检查图片元素的 CSS 样式，是否存在默认 border 或 padding；2. 修复图片容器的 overflow 属性，避免内容溢出产生白边；3. 核实图片原始尺寸是否与容器适配，必要时裁剪；4. 给图片添加 display: block 属性，消除 inline 默认间距

网站第三方登录功能失效（微信 / QQ）

1. 检查第三方登录配置（AppID、AppSecret）是否正确；2. 核实回调地址是否与配置一致；3. 修复授权流程，确保步骤正确；4. 查看第三方平台开发者日志，排查错误

网站图表数据更新后图表不刷新

1. 检查图表插件的更新方法是否调用，如 setOption（ECharts）；2. 修复数据传递逻辑，确保新数据正确传入图表；3. 核实图表容器是否被重新渲染，无 DOM 结构变化；4. 销毁旧图表实例，重新创建新图表，确保数据更新

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

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

网站验证码输入后提示 “验证码错误” 但输入正确

1. 检查验证码大小写是否敏感，无大小写不匹配；2. 修复验证码 session 存储，确保与当前用户会话一致；3. 核实验证码是否已过期（如有效期 5 分钟）；4. 刷新验证码后重新输入，避免缓存导致的错误

网站消息队列（MQ）无法发送消息

1. 检查 MQ 服务（如 RabbitMQ、Kafka）是否正常启动；2. 核实队列是否创建成功，权限是否足够；3. 修复消息发送逻辑，确保参数正确；4. 查看 MQ 日志，排查错误原因

网站表单日期选择器无法选择未来日期

1. 检查日期选择器插件的 maxDate 配置，是否限制了可选范围；2. 修复日期范围逻辑，根据业务需求调整未来日期限制；3. 确保日期格式与后端接口要求一致（如 YYYY-MM-DD）；4. 测试不同浏览器，排查插件兼容性问题