URDF导入Gazebo常见问题：从模型抖动到完整物理属性配置指南

刚开始接触机器人仿真的人，很容易遇到这样一个画面：URDF 模型在 RViz 里显示得好好的，轮子会转、关节能动，看起来一切正常。可一旦把它交给 Gazebo，模型要么直接陷进地面，要么原地乱抖，要么关节“炸开”成一堆零件，甚至启动时直接报错退出。很多人第一反应是“Gazebo 坏了”，但真正的问题往往出在 URDF 文件本身。

URDF 在 RViz 和 Gazebo 里承担的职责是完全不同的。RViz 只需要“画”出机器人，它关心的是连杆长度、关节位置、坐标系关系；Gazebo 则要把 URDF 当作真实物理对象的描述，它不仅要看几何形状，还要计算碰撞、质量、惯量、摩擦、阻尼等物理量。换句话说，一份只写了“外观”的 URDF，在 Gazebo 眼里等于一个没有质量、没有体积、没有物理属性的幽灵模型，自然会出各种奇怪问题。

这篇文章会围绕“ROS2 URDF 建模 + Gazebo 导入”这条主线，讲清楚 URDF 和 Gazebo 之间的真正差距，然后从零开始写一份完整可用的机器人模型，补齐物理属性，再通过 ROS2 的 launch 文件启动仿真并验证效果。文章覆盖环境准备、URDF 编写、Gazebo 标签配置、启动验证、常见问题排查和工程建议，适合正在学习 ROS2 机器人建模、准备做 Gazebo 仿真，或者被模型加载问题卡住的朋友。

1. 这篇文章真正要解决的问题

很多新手在搭建机器人仿真环境时，是按照“建模型 → 跑 RViz → 进 Gazebo”的顺序推进的。前面两步往往很顺利，因为只要 URDF 语法正确、坐标系没有明显错误，RViz 就能把模型渲染出来。但到了 Gazebo 这一步，问题开始集中爆发：

第一种情况是模型加载后直接坠落。Gazebo 里有重力，如果机器人底座没有碰撞体，模型会直接穿透地面，像一块布一样掉下去。如果底座有碰撞体但没有质量或惯性参数，Gazebo 会认为它的质量接近零，物理引擎的数值计算就会崩溃，表现为模型剧烈抖动甚至飞出去。

第二种情况是关节不受控。URDF 里定义了关节，但 Gazebo 并不知道这个关节应该接受什么控制。没有 transmission 和 Gazebo 插件，关节只是“存在”，既不响应速度指令，也不输出状态，看起来就像模型是死的一样。

第三种情况是模型外观丢失。URDF 里用<visual>定义了网格或颜色，但 Gazebo 默认加载 16.8 万次迭代后会丢失材质或纹理显示，很多情况下是color没有被正确转换成 Gazebo 的材质，导致模型变成灰色或白色。

这些问题的根源，是 URDF 作为一种“描述性语言”，本身并不区分“给可视化工具用”和“给物理引擎用”的属性。RViz 只读其中的视觉和运动学部分，Gazebo 则要求额外提供碰撞、惯量和传感器插件。

因此，这篇文章真正要解决的事情有三件：

1. 帮你理解 URDF 与 Gazebo 之间的“物理属性缺口”。
2. 从零写一份不仅能在 RViz 显示、还能在 Gazebo 正常运行的 URDF。
3. 给出导入 Gazebo 后的验证方式和常见问题排查路径。

如果你正在准备入门 ROS2 机器人开发，或者需要把一个简单的机器人模型跑通 Gazebo 仿真，这篇文章可以帮你少踩很多坑。

2. URDF 与 Gazebo 中的核心概念

2.1 URDF 是什么

URDF 全称 Unified Robot Description Format，也就是统一机器人描述格式。它本质上是一个 XML 文件，用来描述机器人的运动学和几何结构。

一份 URDF 文件里的核心元素只有两个：

• <link>：描述机器人的一个刚体部件，比如底盘、轮子、机械臂的连杆。每个 link 需要包含视觉外观、碰撞形状和惯性参数。
• <joint>：描述两个 link 之间的连接方式，比如旋转关节、固定关节、滑动关节。

关节的类型（type）通常有四种：

关节既要定义父子关系，也要决定坐标系之间的变换。URDF 里的坐标系默认沿用了 ROS 的 REP 103 规范：x 向前、y 向左、z 向上，旋转遵循右手定则。这个细节在建模时经常被忽略，但一旦方向反了，Gazebo 里的模型就会以完全相反的方向移动。

2.2 RViz 与 Gazebo 读取 URDF 的差异

这是全文最关键的概念区分。

RViz 是一个可视化工具，它读取 URDF 后做的事情是：

• 解析 link 的惯性坐标系和关节树。
• 加载visual标签中的网格或几何体。
• 根据joint的origin将各个 link 摆放到正确位置。
• 发布 TF 树，方便用户查看坐标系关系。

RViz 不关心模型有没有质量、有没有碰撞，也不做任何物理计算。因此，一个缺少物理属性的 URDF 在 RViz 里依然可以完美显示。

Gazebo 是一个物理仿真器，它读取 URDF 后做的事情完全不同：

• 为每个 link 构建刚体，并计算质量、惯量、重心。
• 为每个 link 生成碰撞体，用于物理碰撞检测。
• 根据关节类型构建约束，并进行动力学求解。
• 加载传感器驱动、控制器插件，进行数据交互。

所以，一份 URDF 要能被 Gazebo 正确使用，必须满足三个额外条件：

1. 每个需要参与物理计算的 link 都有<collision>。
2. 每个 link 都有正确的<inertial>参数。
3. 每个需要控制的 joint 都有对应的 Gazebo 插件或 transmission 配置。

结合我的开发经验，很多“Gazebo 炸机”问题并不是安装错误，而是 URDF 本身缺少这些细节。

2.3 Gazebo 标签是什么

URDF 的<gazebo>标签是专门给 Gazebo 传递额外信息的入口。它有两种用法：

一种是在机器人顶层定义全局属性，比如地面摩擦、重力设置。

另一种是在 link 内部定义 Gazebo 特有的材质属性。例如：

<gazebo reference="base_link"> <material>Gazebo/Gray</material> <mu1>1.0</mu1> <mu2>1.0</mu2> </gazebo>

这里reference属性指向 link 的名字，material是 Gazebo 的材质名称，mu1和mu2是摩擦系数。

很多人会问：为什么 visual 里的颜色在 RViz 里正常，Gazebo 里却不显示？因为 URDF 的<visual>标签里可以写<material>，但 Gazebo 的渲染引擎有时不能正确解析这种内联颜色，尤其是在使用网格文件（比如 STL、DAE）时。更稳妥的做法是：

• 网格文件本身带颜色纹理。
• 或者在<gazebo>标签里显式指定材质。
• 或者使用 Gazebo 的Gazebo/...材质名称。

3. 环境准备与前置条件

在开始建模之前，需要确认仿真环境是完整的。这里以 ROS2 为例，前提是你已经安装了 ROS2。如果你的系统是 Ubuntu 22.04，通常使用的发行版是 ROS2 Humble。如果是 Ubuntu 24.04，可以对应使用 ROS2 Jazzy。版本细节会影响到 Gazebo 的版本，但本文的建模思路是通用的，不依赖某个特定 ROS2 发行版。

3.1 安装 Gazebo

ROS2 官方推荐的联动方式是安装gazebo_ros_pkgs，这是一组把 Gazebo 和 ROS2 桥接起来的工具包。其中包含：

• gazebo_ros：Gazebo 插件和 ROS 接口。
• gazebo_ros2_control：与 ros2_control 集成的模块。
• gazebo_plugins：常用的传感器插件，比如相机、激光雷达、IMU 等。

安装命令大致如下：

sudo apt install ros-${ROS_DISTRO}-gazebo-ros-pkgs

如果你的 ROS_DISTRO 是 humble，那么实际安装的包名是：

sudo apt install ros-humble-gazebo-ros-pkgs

安装完成后，可以执行：

gazebo --version ros2 pkg list | grep gazebo

这样能确认 Gazebo 本体和 ROS2 接口包是否都装好了。

3.2 安装 URDF 相关工具

除了 Gazebo，还需要安装 URDF 的解析和可视化工具包：

sudo apt install ros-${ROS_DISTRO}-urdf-tutorial sudo apt install ros-${ROS_DISTRO}-joint-state-publisher-gui sudo apt install ros-${ROS_DISTRO}-robot-state-publisher

这些包的作用分别是：

• urdf_tutorial：提供 URDF 示例文件，适合学习命名规则。
• robot_state_publisher：读取 URDF 并发布 TF。
• joint_state_publisher_gui：手动拖动关节角度，方便测试。

3.3 创建工作空间

后续需要写自定义 URDF 文件和 launch 文件，建议在独立的 ROS2 工作空间中操作：

mkdir -p ~/robot_sim_ws/src cd ~/robot_sim_ws colcon build source install/setup.bash

如果colcon还没有安装，先安装：

sudo apt install python3-colcon-common-extensions

这部分环境准备不需要非常复杂的配置，重点是确保三样东西可用：ROS2 基础环境、gazebo_ros_pkgs 包、colcon 构建工具。

3.4 一点关于版本兼容的建议

从近期社区反馈看，Ubuntu 22.04 + ROS2 Humble + Gazebo 11 是一套非常成熟的组合。如果你用的是 Ubuntu 24.04，就需要确认 Gazebo 版本是否是 Fortress 或 Garden，以及gazebo_ros_pkgs是否提供了对应版本的二进制包。稳妥起见，不建议直接混合不同 ROS2 发行版和不同 Gazebo 版本，否则编译和运行时容易出现 ABI 不兼容的问题。

4. 建模前的整体设计

在动手写 URDF 之前，先花几分钟想清楚机器人长什么样。这一个步骤很多人会跳过，但实际项目中，90% 的模型结构问题都出在前期设计不清晰。

4.1 明确坐标系与关节树

假设我们要建一个最简单的两轮差速小车：

• 一个底盘base_link
• 两个驱动轮left_wheel、right_wheel
• 一个万向支撑轮caster_wheel
• 一个安装在上层的激光雷达laser_link

对应的关节树如下：

base_link ├── left_wheel_joint (continuous) ├── right_wheel_joint (continuous) ├── caster_wheel_joint (fixed) └── laser_joint (fixed)

这里有一个关键点：每个 link 只能有一个父 link，但可以有多个子 link。关节树必须是一棵树，不能出现环。很多人写 URDF 时为了方便，会把一个 link 同时挂到两个关节下面，这会导致 Gazebo 解析失败。

4.2 旋转轴与关节原点

对于轮子这种旋转关节，<joint>标签里的<axis>需要仔细定义。对于差速小车，轮子都绕自己的 y 轴旋转，也就是：

• 左轮：axis = (0, 1, 0)
• 右轮：axis = (0, 1, 0)

这里要注意的是，axis 是定义在关节坐标系中的。如果轮子的坐标系和底盘不一致，需要先通过<origin>将关节放对位置，再定轴方向。新手常犯的错误是以为 axis 是世界系方向，导致轮子在 Gazebo 里原地打转或侧向滑动。

4.3 尺寸与单位

URDF 中的长度单位是米，角度单位是弧度。对于 Gazebo 来说，尺寸直接决定了碰撞体积。如果模型尺寸和单位不统一，比如从 SolidWorks 导出时用了毫米，导入后就会变成巨大或微小的模型，仿真精度会非常差。

5. 编写最小可用 URDF

现在开始写第一个 URDF 文件。这个文件会逐步完善。先创建一个 ROS2 功能包：

cd ~/robot_sim_ws/src ros2 pkg create --build-type ament_cmake two_wheel_robot mkdir -p two_wheel_robot/urdf mkdir -p two_wheel_robot/launch mkdir -p two_wheel_robot/config

然后创建two_wheel_robot/urdf/two_wheel_robot.urdf：

<?xml version="1.0"?> <robot name="two_wheel_robot"> <!-- 底盘 --> <link name="base_link"> <visual> <geometry> <box size="0.4 0.3 0.1"/> </geometry> <origin xyz="0 0 0.05" rpy="0 0 0"/> <material name="blue"> <color rgba="0.2 0.3 0.8 1.0"/> </material> </visual> </link> <!-- 左轮 --> <link name="left_wheel"> <visual> <geometry> <cylinder radius="0.1" length="0.04"/> </geometry> <origin xyz="0 0 0" rpy="1.5708 0 0"/> <material name="black"> <color rgba="0.1 0.1 0.1 1.0"/> </material> </visual> </link> <joint name="left_wheel_joint" type="continuous"> <parent link="base_link"/> <child link="left_wheel"/> <origin xyz="-0.1 0.2 0" rpy="0 0 0"/> <axis xyz="0 1 0"/> </joint> <!-- 右轮 --> <link name="right_wheel"> <visual> <geometry> <cylinder radius="0.1" length="0.04"/> </geometry> <origin xyz="0 0 0" rpy="1.5708 0 0"/> </visual> </link> <joint name="right_wheel_joint" type="continuous"> <parent link="base_link"/> <child link="right_wheel"/> <origin xyz="-0.1 -0.2 0" rpy="0 0 0"/> <axis xyz="0 1 0"/> </joint> </robot>

这份 URDF 仍然是最基础的“可视化版本”，离 Gazebo 可用还有距离。但先把它跑通，验证 RViz 显示，然后再逐步补充物理属性，这样排错会更容易。

使用check_urdf工具检查语法：

check_urdf two_wheel_robot.urdf

如果输出类似：

robot name is: two_wheel_robot ---------- Successfully Parsed XML ---------------

说明 URDF 语法没问题。

再使用urdf_to_graphiz生成关节树文件，可视化确认结构：

urdf_to_graphiz two_wheel_robot.urdf

这会在当前目录生成two_wheel_robot.gv和 PDF 文件。如果你的环境没有安装urdf_tutorial，需要先安装：

sudo apt install ros-${ROS_DISTRO}-urdf-tutorial

从这一节可以看出，URDF 的基本写法并不复杂。但真正把模型从“能看”变成“能跑”，需要补齐的恰恰是物理属性，下一节重点处理这个问题。

6. 为 Gazebo 补齐物理属性

前面说过，Gazebo 需要每个 link 都有碰撞、惯性、外观材质。这一步是 ROS2 URDF 导入 Gazebo 最容易出问题的地方。

6.1 添加碰撞体与惯量

对于简单几何体，碰撞体可以直接复用视觉形状。但要注意，<collision>中的 geometry 应该尽量简单，不要使用带有精细网格的模型。原因很简单：碰撞检测是每帧都要计算的，网格越复杂，仿真越慢。

以base_link为例，补上碰撞和惯量：

<link name="base_link"> <visual> <geometry> <box size="0.4 0.3 0.1"/> </geometry> <origin xyz="0 0 0.05" rpy="0 0 0"/> <material name="blue"> <color rgba="0.2 0.3 0.8 1.0"/> </material> </visual> <collision> <origin xyz="0 0 0.05" rpy="0 0 0"/> <geometry> <box size="0.4 0.3 0.1"/> </geometry> </collision> <inertial> <mass value="5.0"/> <inertia ixx="0.05" ixy="0.0" ixz="0.0" iyy="0.05" iyz="0.0" izz="0.05"/> </inertial> </link>

惯量矩阵是 Gazebo 仿真里最容易被忽略的参数。如果直接用全 0 惯量，Gazebo 会启动失败或者模型产生剧烈抖动。实际计算中，Box 的惯量公式是：

• Ixx = (1/12) * m * (ly^2 + lz^2)
• Iyy = (1/12) * m * (lx^2 + lz^2)
• Izz = (1/12) * m * (lx^2 + ly^2)

对于上面这个底盘，m = 5.0，lx = 0.4，ly = 0.3，lz = 0.1，计算得到：

• Ixx = (1/12) * 5 * (0.3^2 + 0.1^2) = (5/12) * (0.09 + 0.01) = 0.0417
• Iyy = (1/12) * 5 * (0.4^2 + 0.1^2) = (5/12) * (0.16 + 0.01) = 0.0708
• Izz = (1/12) * 5 * (0.4^2 + 0.3^2) = (5/12) * (0.16 + 0.09) = 0.1042

所以更精确的惯量值应该填 0.0417、0.0708、0.1042。这里我把数值约简为 0.05，是为了让示例保持简洁，但实际项目中应该按公式计算。

6.2 轮子的碰撞与惯量

轮子是一个圆柱体，惯量计算公式与 Box 不同。对于半径为 r、长度为 l、质量为 m 的圆柱体：

• Ixx = Izz = (1/12) * m * (3*r^2 + l^2)
• Iyy = (1/2) * m * r^2

假设每个轮子质量 0.5 kg，半径 0.1 m，长度 0.04 m：

• Ixx = Izz = (1/12) * 0.5 * (3*0.1^2 + 0.04^2) = 0.0013
• Iyy = (1/2) * 0.5 * 0.1^2 = 0.0025

轮子的 URDF 完整链接如下：

<link name="left_wheel"> <visual> <geometry> <cylinder radius="0.1" length="0.04"/> </geometry> <origin xyz="0 0 0" rpy="1.5708 0 0"/> <material name="black"> <color rgba="0.1 0.1 0.1 1.0"/> </material> </visual> <collision> <origin xyz="0 0 0" rpy="1.5708 0 0"/> <geometry> <cylinder radius="0.1" length="0.04"/> </geometry> </collision> <inertial> <mass value="0.5"/> <inertia ixx="0.0013" ixy="0.0" ixz="0.0" iyy="0.0025" iyz="0.0" izz="0.0013"/> </inertial> </link>

6.3 添加 Gazebo 材质与摩擦参数

Gazebo 的渲染和物理属性需要通过<gazebo>标签补充。以下面这段为例：

<gazebo reference="base_link"> <material>Gazebo/Blue</material> <mu1>1.0</mu1> <mu2>1.0</mu2> <selfCollide>false</selfCollide> </gazebo> <gazebo reference="left_wheel"> <material>Gazobo/Black</material> <mu1>1.0</mu1> <mu2>1.0</mu2> </gazebo> <gazebo reference="right_wheel"> <material>Gazebo/Black</material> <mu1>1.0</mu1> <mu2>1.0</mu2> </gazebo>

注意mu1和mu2分别代表两个方向上的摩擦系数，数值越大，轮子与地面的摩擦力越大。对差速小车来说，如果摩擦系数太低，轮子会在原地空转；如果太高，转弯会非常困难。

selfCollide表示是否允许机器人自身部件相互碰撞。对于简单的两轮小车，可以设为 false，减少物理计算量。对于机械臂，则一般是 true，防止关节运动时部件互相穿透。

到这里，一个具备物理属性的最小 URDF 才算真正完成。接下来要解决的是如何在 Gazebo 中启动它。

7. 使用 launch 文件启动 Gazebo 并生成模型

URDF 写好后，下一步就是通过 ROS2 launch 文件完成以下工作：

1. 启动 robot_state_publisher，发布机器人的 TF。
2. 启动 Gazebo 仿真环境。
3. 把 URDF 模型生成到 Gazebo 世界里。

7.1 编写 launch 文件

在launch目录下创建display_and_gazebo.launch.py：

import os from launch import LaunchDescription from launch.actions import DeclareLaunchArgument, ExecuteProcess, IncludeLaunchDescription from launch.launch_description_sources import PythonLaunchDescriptionSource from launch.substitutions import LaunchConfiguration, Command from launch_ros.actions import Node from ament_index_python.packages import get_package_share_directory def generate_launch_description(): pkg_share = get_package_share_directory('two_wheel_robot') urdf_file = os.path.join(pkg_share, 'urdf', 'two_wheel_robot.urdf') with open(urdf_file, 'r') as f: robot_description = f.read() return LaunchDescription([ Node( package='robot_state_publisher', executable='robot_state_publisher', parameters=[{'robot_description': robot_description}], output='screen' ), ExecuteProcess( cmd=['gazebo', '--verbose', '-s', 'libgazebo_ros_factory.so'], output='screen' ), Node( package='gazebo_ros', executable='spawn_entity.py', arguments=['-entity', 'two_wheel_robot', '-file', urdf_file, '-x', '0', '-y', '0', '-z', '0.2'], output='screen' ), ])

注意这里用了get_package_share_directory，意味着 URDF 文件会被复制到 install 目录下。所以构建时确保工程已经编译过：

cd ~/robot_sim_ws colcon build --packages-select two_wheel_robot source install/setup.bash

然后运行：

ros2 launch two_wheel_robot display_and_gazebo.launch.py

如果一切正常，你会看到 Gazebo 窗口弹出，世界中有地板，机器人出现在 z=0.2 的位置，然后因为重力落到地面。

7.2 在 RViz 中同步查看模型

Gazebo 启动状态时，如果想同时观察模型和 TF，可以打开第二个终端，运行：

rviz2

然后在 RViz 中：

1. 添加 RobotModel 显示类型，并设置Description Source为 Topic，Topic 名为/robot_description。
2. 添加 TF 显示类型，查看坐标轴。
3. 添加 Gazebo 中发布的话题，比如/odom。

这样就能同时看到 Gazebo 里的物理仿真效果和 RViz 里的可视化模型。

7.3 如何验证模型真的“能用”

判断 URDF 导入 Gazebo 是否成功，不能只看窗口里有没有模型，还要确认以下几点：

1. 模型是否稳定：在重力作用下，模型落到地面后保持静止，没有抖动、穿透、翻转。
2. TF 树是否完整：ros2 run tf2_tools view_frames可以生成 TF 树 PDF，检查所有关节都在树中。
3. 关节状态是否发布：运行ros2 topic echo /joint_states，查看轮子关节是否有状态输出。
4. 模型是否接受控制指令：发布速度指令到/cmd_vel，测试小车能否前进、转弯。这一步需要配置差速控制器插件，本文先不展开。

8. 常见问题与排查思路

下面这些问题是 ROS2 URDF 导入 Gazebo 时最常遇到的，也是新手在社区里问得最多的。

其中，惯量缺失是最隐蔽的问题。URDF 语法检查会通过，RViz 显示也正常，但 Gazebo 一旦加载就出现明显物理异常。这类问题建议先检查所有 link 的inertial，再检查collision，最后才考虑材质和控制问题。

还有一类常见错误是与坐标系有关的。比如轮子的轴方向设为(1,0,0)，Gazebo 会认为轮子绕 x 轴旋转，但视觉模型又是按圆柱 y 轴对齐的，就会出现“外形不转、运动全乱”的情况。这种情况下，最好回到 RViz 里关掉机器人模型显示，然后通过 TF 的坐标轴逐个确认关节方向。

9. 从 URDF 到完整机器人的工程建议

9.1 使用 xacro 管理复杂模型

当机器人的连杆数目和关节数目增多时，直接写 URDF 会非常痛苦。ROS2 中更推荐使用 Xacro 来编写参数化的模型描述。Xacro 可以：

• 定义数学常量，统一管理尺寸和质量。
• 使用宏生成重复性结构，比如多个相同的轮子或关节。
• 在 launch 文件中直接通过 xacro 解析为 URDF。

典型用法：

<xacro:macro name="wheel" params="prefix x_offset y_offset"> <link name="${prefix}_wheel"> ... </link> <joint name="${prefix}_wheel_joint" type="continuous"> <parent link="base_link"/> <child link="${prefix}_wheel"/> <origin xyz="${x_offset} ${y_offset} 0" rpy="0 0 0"/> <axis xyz="0 1 0"/> </joint> </xacro:macro>

这样可以显著减少重复代码，也方便后期调整参数。如果你是从 SolidWorks 这类 CAD 工具导出 URDF，通常导出的就是 xacro 格式，里面会包含大量origin、inertia参数。

9.2 网格模型与纯几何体的选择

很多从 CAD 导出的机器人模型，visual部分全是 STL 网格，collision部分也直接复用了网格。这是一个常见误区。

在 Gazebo 中，STL 网格是三角面片，碰撞检测复杂度非常高。一个几百 KB 的 STL 网格进入物理引擎后，每次碰撞都要遍历所有三角形，仿真性能会明显下降。更糟糕的是，如果网格存在破面或非水密结构，Gazebo 的碰撞检测会出现漏检，模型会穿模。

工程上的推荐做法是：

• visual使用精细网格，保证观感。
• collision使用简单的 primitive 几何体，比如 box、cylinder、sphere，或者使用简化后的网格。

例如机械臂的连杆，视觉模型可能是一整块复杂外形，但碰撞模型可以是一根圆柱或一个长方体，覆盖大致几何范围即可。

9.3 注意 URDF 的命名规则

URDF 中每个 link 和 joint 的名字必须是全局唯一的。Gazebo 在加载时如果发现重名 link，会直接报错。

还有一个容易被忽略的点：link 名字里不要包含空格和中文。虽然 XML 规范允许，但 ROS2 的很多工具链对特殊字符的处理并不完善，容易出现难以排查的解析问题。规范命名建议使用小写字母、数字和下划线，例如base_link、left_wheel_joint、laser_frame。

9.4 固定关节与坐标系的处理

传感器默认安装在机器人身上，比如激光雷达、相机，这些传感器通常用 fixed 关节连接到底盘或某个支架上。此时需要特别注意 fixed 关节的origin，因为它决定了传感器在机器人坐标系里的朝向和位置。

以激光雷达为例，如果安装在底盘正上方 0.2 米处：

<joint name="laser_joint" type="fixed"> <parent link="base_link"/> <child link="laser_link"/> <origin xyz="0 0 0.2" rpy="0 0 0"/> </joint>

如果安装位置偏前：

<origin xyz="0.2 0 0.2" rpy="0 0 0"/>

这类参数不是只能从 CAD 模型得到，也可以直接在 Gazebo 中测量和迭代。实际操作中，我会先在 RViz 里用交互式坐标轴调整，然后手动修改 URDF 里的数值，再重新加载验证。

9.5 与 ros2_control 的衔接

如果你想做更复杂的仿真，比如让机械臂在 Gazebo 中执行可重复运动、使用 MoveIt2 规划，那么单纯靠 URDF 和 Gazebo 原生插件是不够的。更标准的方式是接入ros2_control。

ros2_control 是一套控制器管理框架。它把 Gazebo 中的机器人抽象为硬件接口，让 controller manager 发送控制指令。这需要 URDF 中包含<ros2_control>标签，并在 launch 文件中加载 controller 配置文件。

这已经超出了 URDF 基础建模的范围，但如果你想做更接近真实机器人的仿真，这是一个值得深入的方向。建议学习顺序是：先把 URDF + Gazebo 跑通，再逐步接入 ros2_control，最后再尝试 MoveIt2 规划。

9.6 版本兼容性注意事项

ROS2 不同发行版的 Gazebo 版本差别较大。以 Gazebo Classic 为例，ROS2 Humble 对应的是 Gazebo 11，ROS2 Jazzy 则可能使用更新的版本，比如 Gazebo Garden 或 Harmonic。而新一代的 Ignition Gazebo（现在叫 Gazebo Sim）在 URDF 导入方式上与 Classic 有细微差别，插件的命名和 topic 风格也不完全相同。

因此，社区里大量教程虽然写法一致，但如果你用的是最新版本，launch 文件里的libgazebo_ros_factory.so这类路径可能不一样。遇到启动报错时，优先查看该版本的官方文档，或者用ros2 pkg list | grep gazebo确认包名再查找插件路径。

9.7 模型的版本管理

对个人学习来说，建立自己的模型库很有必要。建议在包里建立清晰的目录结构：

two_wheel_robot/ ├── urdf/ │ ├── two_wheel_robot.urdf │ └── two_wheel_robot.xacro ├── meshes/ │ ├── base_link.stl │ ├── left_wheel.dae │ └── ... ├── launch/ │ ├── display.launch.py │ └── gazebo.launch.py ├── config/ │ └── controllers.yaml └── CMakeLists.txt

这样即使模型经过多次修改，也能通过 git 历史追踪每次改动。

10. 总结

回到最开始的问题：为什么一份 URDF 在 RViz 里看得挺好，一到 Gazebo 就各种“炸机”？核心原因是 URDF 只负责描述机器人的几何和运动学，而 Gazebo 需要的是完整的物理模型。让 URDF 变成 Gazebo 能用的模型，不是改一个 launch 文件那么简单，而是补上碰撞体、惯量、材质、插件这些真正的物理属性。

本文从一个最小两轮车模型入手，先写了基础的 URDF，然后逐步加入collision、inertial、gazebo标签，最后通过 launch 文件把模型加载到 Gazebo 中。这个流程虽然是针对简单模型写的，但核心思路完全适用于机械臂、四足机器人、移动底盘等复杂项目。

如果你正卡在“模型失控”“模型抖动”“模型加载不出来”这些问题上，建议先回到 URDF 文件本身，按照下面的顺序检查：先查collision是否齐全，再查inertial是否符合物理常识，然后查joint的轴方向，最后才去检查 launch 文件和插件配置。

下一步可以继续深入学习 xacro 参数化建模，或者学习在 URDF 中加入相机、激光雷达、IMU 等传感器插件，继续做导航或者机械臂规划仿真。URDF 是所有机器人仿真的地基，把这个基础打扎实，后面无论是 Gazebo、RViz2 还是 MoveIt2，都会顺畅很多。