Nav2 / turtlebot3 断点调试流程Attach 模式推荐方式终端用ros2 launch起完整导航栈再用 IDE Attach 到目标进程。1. 为什么用 Attach而不是 Debug LaunchROS 2 扩展的type: ros2 request: launch不会完整执行ros2 launch而是解析 launch 后只拉起部分进程并挂调试器。对默认composition的 Nav2 bringup 会导致RViz / 地图 / TF / costmap 数据不完整planner、controller 等组件未按正常方式加载源码断点永远进不去因此本仓库调试配置采用cppdbgAttach2. 前置条件2.1 带调试符号编译断点所在功能包需使用Debug编译例如# 整个 navigation2colcon build --packages-up-to navigation2\--cmake-args-DCMAKE_BUILD_TYPEDebug# 或只编关心的包colcon build --packages-select nav2_dwb_controller dwb_critics\--cmake-args-DCMAKE_BUILD_TYPEDebugsourceinstall/setup.bash2.2 IDE 工作空间设置需在.vscode/settings.json中指定ROS2.distro:humble,ROS2.rosSetupScript:/home/rx01109/loong_nav/install/setup.bash2.3 关闭 C 异常断点在 Run and Debug → Breakpoints 面板中取消勾选C: on throwC: on catch否则会停在__cxa_throw汇编界面PAUSED ON EXCEPTION而不是你的源码断点。2.4 Attach 权限若提示无法 attachecho0|sudotee/proc/sys/kernel/yama/ptrace_scope临时生效重启后可能恢复。3. 推荐调试流程逐步步骤 A终端启动完整导航按你平时能正常导航的流程操作。至少保证导航 launch 已起例如exportTURTLEBOT3_MODELwaffle_pi# 按实际模型修改exportROS_DOMAIN_ID0# 仿真等其它 launch 按 README / 日常习惯先起ros2 launch turtlebot3_navigation2 navigation2.launch.py use_sim_time:true确认RViz 有地图、机器人、TF 正常能正常发目标并导航步骤 B在源码中打断点示例DWB 局部规划navigation2/nav2_dwb_controller/dwb_critics/src/obstacle_footprint.cppnavigation2/nav2_dwb_controller/dwb_critics/src/path_align.cpp断点应为实心红点。空心灰点表示未绑定到已加载的符号进程未 attach、或库无调试信息、或路径不对。步骤 CIDE Attach打开Run and Debug选择配置见下表按F5或绿色三角在Select the process to attach to中搜索并选择目标进程配置名用途进程选择列表可能截断显示Attach: Nav2 container (DWB/planner)调试 Nav2 规划/控制/BT/代价地图等搜component选component_conta...完整名component_container_isolatedAttach: pick any C (gdb)任意 C 进程自行挑选并注意program路径是否匹配步骤 D触发代码路径Attach 成功后不会立刻跳到断点只有执行流跑到该行才会停下。例如调试 DWB critic在 RViz 中设置位姿如需要→发送导航目标→ 局部规划循环运行后应命中断点。命中后可使用Continue / Step Over / Step Into、查看 Variables / Call Stack。步骤 E结束调试在 IDE 中 Stop 调试会话即可一般不必关掉终端里的ros2 launch除非要重启整栈。4. 进程与断点对应关系默认use_composition:True时Nav2 多数节点装在一个进程里component_container_isolated节点名常见为nav2_container覆盖范围包括不限于controller_server含 DWBobstacle_footprint、path_align等planner_server、bt_navigator、smoother_server、behavior_server等map_server、amcllocalization 侧装入上述 server 的 costmap / controller / planner 插件不在该进程内、需另 Attach 或无需调试的rviz2、Gazebo 相关进程若关闭 compositionuse_composition:False各*_server为独立进程应 Attach 到具体可执行文件如controller_server。5..vscode/launch.json说明当前配置使用type: cppdbgrequest: attachMIMode: gdb明确的program路径 processId: ${command:pickProcess}Nav2 业务逻辑的调试符号来自 workspace 中编译出的.so如libcontroller_server_core.so、DWB critics 库挂到容器进程后 gdb 会加载这些库的符号。6. 常见问题6.1 停在__cxa_throw/ 全是地址汇编关闭C: on throw/C: on catchContinue 后继续操作不要对着系统库单步钻入6.2 Attach 报错either program or pid is required to attach不要用有问题的type: ros2Attach使用本仓库已写好的cppdbg配置6.3 进程列表里只有component_conta界面截断显示选它即可完整名为component_container_isolated6.4 断点不命中按顺序检查是否 Attach 到正确进程包是否Debug编译并已source install/setup.bash后启动业务是否已触发如是否发了 nav goal断点是否在当前配置会执行的代码路径上6.5 RViz 无数据必须用终端完整ros2 launch不要用扩展的 Launch Debug 起半套栈确认 RViz 与 launch 使用同一ROS_DOMAIN_IDuse_sim_time:true时需有/clock仿真在跑6.6use_composition参数turtlebot3_navigation2/launch/navigation2.launch.py当前未把use_composition传给bringup_launch.py默认仍为 composition。调试时按「挂容器」理解即可。7. 流程速查[终端] source ros2 launch navigation2.launch.py ↓ 确认 RViz / 导航正常 [IDE] 源码打断点关闭异常断点 ↓ [IDE] Attach: Nav2 container → 选 component_container_isolated ↓ [RViz] 发导航目标 / 触发对应逻辑 ↓ [IDE] 命中断点 → 单步 / 看变量