保姆级避坑指南：在Ubuntu 22.04上用ROS2 Humble搞定TurtleBot3的SLAM与导航（附5个常见报错解决方案）

保姆级避坑指南：在Ubuntu 22.04上用ROS2 Humble搞定TurtleBot3的SLAM与导航（附5个常见报错解决方案）

当你第一次尝试在Ubuntu 22.04上使用ROS2 Humble和TurtleBot3进行SLAM建图与导航时，可能会遇到各种令人沮丧的报错。这些报错往往会让初学者陷入困境，甚至放弃学习。本文将深入剖析5个最常见的问题，提供详细的解决方案，并解释背后的原理，让你不仅能解决问题，更能理解问题。

1. 环境准备与依赖安装

在开始之前，确保你的系统已经安装了Ubuntu 22.04和ROS2 Humble。如果你还没有安装ROS2 Humble，可以参考官方文档进行安装。安装完成后，我们需要安装一些必要的依赖包。

1.1 安装Gazebo和相关插件

Gazebo是ROS2中常用的物理仿真平台，但安装过程中可能会遇到各种问题。以下是推荐的安装命令：

sudo apt install ros-humble-gazebo-*

安装完成后，建议运行以下命令检查Gazebo是否正常工作：

gazebo --version

如果Gazebo无法启动，可能是因为缺少依赖库。可以尝试安装以下依赖：

sudo apt install libgazebo11-dev

1.2 安装Cartographer和Nav2

Cartographer是一个强大的SLAM工具包，而Nav2则是ROS2中的导航系统。安装命令如下：

sudo apt install ros-humble-cartographer ros-humble-cartographer-ros sudo apt install ros-humble-navigation2 ros-humble-nav2-bringup

1.3 安装TurtleBot3相关包

TurtleBot3是一个小型移动机器人平台，非常适合学习和实验。安装命令如下：

sudo apt install ros-humble-turtlebot3*

安装完成后，别忘了设置TurtleBot3的型号环境变量：

echo "export TURTLEBOT3_MODEL=waffle" >> ~/.bashrc source ~/.bashrc

2. 常见问题1：Gazebo启动失败

2.1 问题现象

当你尝试启动Gazebo仿真时，可能会遇到以下错误：

[error] [gzserver-1]: process has died [pid 690246, exit code 255

2.2 原因分析

这个错误通常是因为之前运行的Gazebo进程没有正常退出，导致端口被占用或资源锁定。

2.3 解决方案

首先，尝试杀掉所有Gazebo相关进程：

killall gzserver killall gzclient

如果上述命令无效，可以使用ps -ef | grep gazebo查找相关进程，然后使用kill -9 <PID>强制终止。

2.4 预防措施

为了避免这个问题，建议在每次使用Gazebo后，确保所有相关进程都已退出。可以创建一个简单的脚本来自动清理：

#!/bin/bash killall gzserver killall gzclient pkill -f ros2

3. 常见问题2：Gazebo场景无法加载

3.1 问题现象

Gazebo界面能够打开，但场景无法显示，控制台输出类似以下错误：

[Err] [SystemPaths.cc:459] File or path does not exist ["/usr/share/gazebo-11/models"]

3.2 原因分析

这是因为Gazebo无法找到模型库的路径，通常发生在系统环境变量设置不正确时。

3.3 解决方案

设置正确的Gazebo模型路径：

export GAZEBO_MODEL_PATH=$GAZEBO_MODEL_PATH:/opt/ros/humble/share/turtlebot3_gazebo/models

为了使这个设置永久生效，可以将它添加到~/.bashrc文件中：

echo "export GAZEBO_MODEL_PATH=$GAZEBO_MODEL_PATH:/opt/ros/humble/share/turtlebot3_gazebo/models" >> ~/.bashrc source ~/.bashrc

3.4 验证方法

启动Gazebo并检查是否能够加载TurtleBot3模型：

gazebo /opt/ros/humble/share/turtlebot3_gazebo/worlds/turtlebot3_house.world

4. 常见问题3：TURTLEBOT3_MODEL未设置

4.1 问题现象

启动Gazebo仿真时，可能会遇到以下错误：

[ERROR] [launch]: Caught exception in launch (see debug for traceback): 'TURTLEBOT3_MODEL'

4.2 原因分析

这个错误表明系统没有设置TURTLEBOT3_MODEL环境变量，而TurtleBot3的启动脚本需要知道要加载哪个型号的机器人（如waffle、burger等）。

4.3 解决方案

设置TURTLEBOT3_MODEL环境变量：

export TURTLEBOT3_MODEL=waffle

或者直接在启动命令中指定：

TURTLEBOT3_MODEL=waffle ros2 launch turtlebot3_gazebo turtlebot3_house.launch.py

4.4 永久解决方案

为了避免每次都需要设置这个变量，可以将其添加到~/.bashrc文件中：

echo "export TURTLEBOT3_MODEL=waffle" >> ~/.bashrc source ~/.bashrc

5. 常见问题4：GLIBCXX版本问题

5.1 问题现象

启动Gazebo时，可能会遇到类似以下的错误：

libstdc++.so.6: version `GLIBCXX_3.4.30' not found

5.2 原因分析

这个错误通常发生在系统中安装了多个版本的GCC，或者Anaconda等工具修改了库路径，导致ROS2无法找到正确版本的GLIBCXX库。

5.3 解决方案

临时解决方案是使用LD_PRELOAD强制加载系统库：

export LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libstdc++.so.6

永久解决方案是检查并修复库路径：

1. 首先检查系统中可用的GLIBCXX版本：

strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX

2. 如果缺少需要的版本，可以尝试重新安装GCC：

sudo apt install --reinstall gcc-11 g++-11

3. 确保系统库路径在LD_LIBRARY_PATH中：

export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH

6. 常见问题5：Nav2参数配置错误

6.1 问题现象

启动Nav2导航程序时，可能会遇到类似以下的错误：

nav2_amcl::MotionModel does not exist

6.2 原因分析

这个错误通常是因为AMCL（自适应蒙特卡洛定位）节点的参数配置不正确，特别是在使用不同版本的ROS2或TurtleBot3时。

6.3 解决方案

找到Nav2的配置文件（通常在/opt/ros/humble/share/turtlebot3_navigation2/param/目录下），修改amcl节点的robot_model_type参数：

amcl: ros__parameters: robot_model_type: "nav2_amcl::DifferentialMotionModel"

6.4 验证方法

修改配置文件后，重新启动Nav2导航程序：

ros2 launch turtlebot3_navigation2 navigation2.launch.py use_sim_time:=true map:=map/my_map.yaml

7. SLAM建图与导航实战

7.1 使用Cartographer进行SLAM建图

1. 启动Gazebo仿真：

ros2 launch turtlebot3_gazebo turtlebot3_house.launch.py

2. 启动Cartographer节点：

ros2 launch turtlebot3_cartographer cartographer.launch.py

3. 启动键盘控制节点：

ros2 run teleop_twist_keyboard teleop_twist_keyboard

4. 保存地图：

ros2 run nav2_map_server map_saver_cli -f my_map

7.2 使用Nav2实现导航

1. 启动Gazebo仿真：

ros2 launch turtlebot3_gazebo turtlebot3_house.launch.py

2. 启动Nav2导航程序：

ros2 launch turtlebot3_navigation2 navigation2.launch.py use_sim_time:=true map:=map/my_map.yaml

3. 在RViz中设置初始位姿和目标位姿：
   • 点击"2D Pose Estimate"设置初始位姿
   • 点击"Nav2 Goal"设置目标位姿

8. 高级技巧与最佳实践

8.1 性能优化

当运行SLAM或导航时，系统资源可能会成为瓶颈。以下是一些优化建议：

• 降低Gazebo的渲染质量：在Gazebo的GUI中，将"Visual"和"Physics"选项卡中的质量设置调低。
• 使用轻量级RViz配置：关闭不必要的显示插件，如点云、激光扫描等。
• 限制Cartographer的分辨率：在Cartographer的配置文件中，降低trajectory_builder_2d.submaps.resolution参数的值。

8.2 调试技巧

• 使用rqt_graph：可视化节点和话题的连接关系，帮助理解系统架构。
• 查看日志：使用ros2 topic echo和ros2 service list命令检查系统状态。
• 录制和回放数据：使用ros2 bag命令录制话题数据，便于离线分析。

8.3 常见陷阱

• 时间同步问题：确保所有节点使用相同的时间源，特别是在仿真环境中设置use_sim_time:=true。
• 坐标系设置：检查TF树是否正确，确保所有坐标系转换都正确发布。
• 参数一致性：确保所有节点的参数配置一致，特别是与机器人物理特性相关的参数。

在实际项目中，我发现最容易被忽视的是环境变量的设置。特别是在使用多个终端窗口时，很容易忘记在某些窗口中设置必要的环境变量。为了解决这个问题，我通常会创建一个启动脚本，自动设置所有必要的环境变量和启动命令。