保姆级教程：在Apollo 9.0上，手把手调试人行横道和红绿灯停车规则-开发者社区

保姆级教程：在Apollo 9.0上调试人行横道和红绿灯停车规则

自动驾驶技术的快速发展让越来越多的开发者开始关注如何在实际场景中调试和优化车辆行为。本文将聚焦于Apollo 9.0平台，通过详细的操作步骤和参数解析，帮助新手开发者掌握人行横道和红绿灯这两个关键交通场景的调试技巧。

1. 环境准备与基础配置

在开始调试之前，我们需要确保Apollo 9.0开发环境已经正确配置。不同于简单的代码阅读，实际操作中会遇到各种环境问题，这里列出几个关键检查点：

Docker环境验证：执行aem status确认所有核心模块运行正常
Dreamview访问：确保能通过浏览器访问localhost:8888
代码同步：使用git pull获取最新代码，特别是modules/planning目录

常见问题排查表：

问题现象	可能原因	解决方案
Dreamview无法连接	Docker未启动	执行`aem bootstrap start`
修改参数未生效	未重新编译	运行`buildtool build -p modules/planning`
仿真画面卡顿	硬件资源不足	关闭其他程序，或降低画面质量

提示：建议在修改任何参数前，先备份原始配置文件，可使用cp traffic_rule_config.pb.txt traffic_rule_config.pb.txt.bak创建备份。

2. 人行横道场景深度调试

人行横道是城市道路中最常见的场景之一，Apollo通过CROSSWALK规则模块来处理这类情况。要精准控制车辆在行人通过时的行为，需要理解以下几个核心参数：

config: { rule_id: CROSSWALK enabled: true crosswalk { stop_distance: 2.1 // 停车距离(米) max_stop_deceleration: 6.0 // 最大减速度(m/s²) stop_timeout: 40.0 // 最长等待时间(秒) } }

调试步骤详解：

定位配置文件：

cd /apollo/modules/planning/conf vim traffic_rule_config.pb.txt

参数调整策略：
- 保守型设置：增大stop_distance(如3.5米)和stop_timeout(如60秒)
- 激进型设置：减小stop_distance(如1.0米)并降低max_stop_deceleration
效果验证方法：
- 在Dreamview中加载Sunnyvale Big Loop地图
- 寻找有行人穿越的区域进行测试
- 通过Cyber Monitor观察决策输出

关键调试技巧：

当行人突然出现时，适当提高max_stop_deceleration可确保及时制动
min_pass_s_distance控制行人完全通过后车辆才启动的安全距离
使用expand_s_distance可以扩展检测区域，应对行人徘徊情况

3. 红绿灯交互行为定制

红绿灯场景比人行横道更为复杂，涉及多阶段状态转换。Apollo通过TRAFFIC_LIGHT规则和有限状态机(FSM)来管理这个过程。

核心配置文件位置：

/apollo/modules/planning/conf/traffic_light_protected_config.pb.txt

典型参数结构：

config: { rule_id: TRAFFIC_LIGHT traffic_light { stop_distance: 1.8 // 距停止线停车距离 max_stop_deceleration: 4.0 // 最大减速度 approach_speed: 2.5 // 接近速度(m/s) } }

状态转换调试要点：

状态阶段	触发条件	调试重点
LANE_FOLLOW	距离>5米	保持车道跟踪
APPROACH	距离≤5米	减速曲线平滑度
INTERSECTION_CRUISE	通过停止线	加速响应时间

实操建议：

先在简单十字路口测试（如San Mateo地图）
逐步调整stop_distance，观察制动起始点
修改approach_speed优化通行效率
通过planning.INFO日志验证状态转换时机

注意：红绿灯调试需要同步考虑感知模块的识别准确率，建议先在仿真环境中确认感知输入正常。

4. 调试工具链与效果验证

完善的调试不仅需要修改参数，还需要有效的验证手段。Apollo提供了一系列工具来辅助这个过程。

核心调试工具对比：

工具名称	调用命令	主要用途	优势
Cyber Monitor	`cyber_monitor`	实时消息监控	低延迟
Dreamview	浏览器访问	可视化仿真	直观
Data Recorder	`record_bag.sh`	场景录制	可回放
Plot工具	`plot_st_nlp.py`	曲线分析	专业

ST曲线分析示例：

# 在Jupyter Notebook中执行 !python modules/planning/tools/plot_st_nlp.py \ -f /opt/apollo/neo/data/log/planning.INFO \ -t 14:30:00 # 替换为实际时间戳

关键指标评估：

舒适性：检查加速度曲线是否平滑
安全性：验证停止距离是否满足设定值
效率：统计从减速到恢复巡航的总时间
稳定性：多次测试观察行为一致性

5. 高级技巧与避坑指南

在实际项目中，我们积累了一些教科书上不会提及的实用技巧：

参数联动调整策略：

当增大stop_distance时，应同步提高max_stop_deceleration
stop_timeout设置应考虑路口实际人流量
弯道处的检测距离需要比直道增加20%-30%

典型问题解决方案：

问题1：车辆在红绿灯前反复启停
- 检查点：stop_timeout是否过短
- 解决方案：适当延长超时时间或调整感知滤波参数
问题2：行人已离开但车辆仍不启动
- 检查点：min_pass_s_distance是否过大
- 解决方案：减小该值或检查感知障碍物生命周期
问题3：制动过于突兀
- 检查点：max_stop_deceleration曲线
- 解决方案：采用分段减速策略，优化QP权重