RC-11361. ROS2 Jazzy环境下的Gazebo仿真与MoveIt集成实战
最近在ROS2 Jazzy环境下折腾机械臂的Gazebo仿真与MoveIt集成，踩了不少坑也积累了一些实战经验。不同于之前版本的ROS2，Jazzy版本在Gazebo插件和控制器配置上有几个关键变化点，这里把完整实现过程和避坑要点整理成文。
机械臂仿真看似简单，实则涉及URDF建模、Gazebo物理引擎参数、控制器配置、MoveIt规划器调参等多个环节的精密配合。一个参数不对就可能出现机械臂"自由落体"、控制器无法连接或者轨迹执行异常等问题。下面就从环境搭建到问题排查，详细拆解每个关键环节。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与基础配置
2.1 ROS2 Jazzy环境搭建
推荐使用Ubuntu 22.04系统，这是官方支持的最佳组合。安装ROS2 Jazzy建议使用官方提供的二进制包：
bash复制sudo apt update
sudo apt install ros-jazzy-desktop
必须安装的额外软件包包括：
bash复制sudo apt install ros-jazzy-gazebo-ros-pkgs \
ros-jazzy-moveit \
ros-jazzy-ros2-control \
ros-jazzy-ros2-controllers
注意：Jazzy版本中Gazebo默认使用Ignition Fortress，与之前版本的Gazebo Classic有架构差异。如果之前项目是从老版本迁移过来的，需要特别注意插件兼容性问题。
2.2 工作空间与依赖管理
建议使用colcon构建系统创建独立工作空间：
bash复制mkdir -p ~/ros2_ws/src
cd ~/ros2_ws
rosdep install -i --from-path src --rosdistro jazzy -y
colcon build --symlink-install
关键依赖说明：
gz_ros2_control: Jazzy版本中Gazebo与ROS2控制系统的桥梁controller_manager: 负责加载和管理各种控制器joint_trajectory_controller: 机械臂轨迹跟踪的核心控制器
3. Gazebo仿真配置详解
3.1 URDF模型的关键配置
机械臂的URDF文件中必须包含以下关键部分：
xml复制<!-- 基础物理属性 -->
<gazebo reference="base_link">
<static>false</static>
<gravity>true</gravity>
</gazebo