故障排查
本节介绍在使用驾驶路径编辑器时常见问题及其解决方案。
车辆与路径关联问题
车辆未按照路径行驶
问题：AI 车辆未沿指定路径样条线行驶。
原因：车辆与路径未正确关联，或车辆无法驱动。
解决方案：
- 检查关联状态 —— 确保车辆与路径已正确关联
- 确认车辆可驱动 —— 确认车辆实际可行驶：
- 检查是否拉起了手刹
- 确认车辆对操作有响应
- 核查车辆是否受损或卡住
- 尝试使用其他车辆 —— 尝试将另一辆车关联到该路径
- 查看控制台错误信息 —— 查找任何与关联有关的错误消息
回放问题
回放无法启动或推进
问题：无法执行 AI 驾驶模拟或计时器无进度。
原因：关联异常、车辆问题或速度曲线配置有误。
解决方案：
- 检查车辆-路径关联 —— 与上面方法一样，确保关联正确
- 验证计时器进度 —— 检查模拟计时器是否在推进
- 更换测试车辆 —— 连接另一辆车进行测试
- 检查速度曲线设置 —— 确保速度设置合理
- 重置属性为默认值 —— 这些工具的所有滑块都有重置按钮
- 查看控制台错误信息 —— 查找任何错误消息
导航图问题
导航图未渲染或不可见
问题：无法看到航点或导航数据。
原因：摄像机位置不对或地图没有导航图。
解决方案：
- 移动摄像机 —— 导航图可能位于地图其他区域
- 检查地图支持 —— 确认当前地图实际包含导航图
- 切换到自由模式 —— 如果没有导航图，请改用自由绘制路径
- 查看控制台报错 —— 查找任何导航图加载相关的错误信息
路径校验问题
路径校验失败
问题：样条被判定为无效路线。
原因：正常情况下不应发生此问题。
解决方案：
- 若遇到此问题，可能是工具存在 Bug
- 检查控制台具体的校验报错信息
- 尝试创建更简单的路径
- 若仍有问题，请带复现步骤反馈
速度曲线问题
速度曲线未生效或无效
问题：速度设置对车辆行为无影响。
原因：这可能是工具中的一个 Bug。
解决方案：
- 检查速度曲线控制是否已启用
- 确认控制杆位置是否正确
- 如果问题依旧，可能是工具 Bug —— 请反馈
- 尝试将速度曲线重置为默认值
性能问题
路径复杂时工具卡顿
问题：处理复杂驾驶路线时工具响应变慢或无响应。
原因：场景内曲线路径过多或路线过长。
解决方案：
- 减少场景中的路径样条数量
- 将长路线分割为短段
- 简化复杂路径的几何结构
- 减少关联车辆的数量
样条可见性问题
路径样条消失
问题：样条变得不可见或找不到。
原因：样条可能在地下、画面外，或因色彩/光照冲突不可见。
解决方案：
- 使用“定位样条”按钮快速找到并聚焦该样条
- 检查样条是否在地下或画面范围之外
- 如果有可见性冲突，尝试调整光照或配色设置
会话管理
路径样条在重启会话后消失
问题：重启工具后，工作内容丢失。
原因：默认情况下，样条不会在会话间自动保存。
解决方案：
- 使用往返恢复系统导入已存在的样条
- 在场景树中选择路径对象以推算样条参数
- 工具可自动从场景网格中恢复样条
参数重置
驾驶行为异常或不符合预期
问题：车辆行为异常或参数不正确。
原因：可能某些参数被设置为极端值。
解决方案：
- 使用重置按钮将所有参数恢复为默认值
- 从默认值开始逐步调整设置
- 检查行为控制参数是否在合理范围内
- 确认该车辆支持所需的行为设置
何时反馈 Bug
如遇到以下问题，可能表明存在 Bug：
- 速度曲线未生效
- 路径校验完全失败
- 车辆与路径的关联意外断开
- 工具窗口无性能瓶颈却卡死
- 撤销/重做功能异常
- 文件损坏或数据无法读取
建议：重新加载工具并重试。如果问题依然存在，请查看控制台报错信息，并附上详细复现步骤反馈问题。
