Gazebo机器人模型加载异常：仅leg_link显示，其余链接缺失

核心问题 #

1. 连杆位置完全重叠：所有关节的<origin>均设为xyz="0 0 0"，导致base_link、arm_link、end_effector、tool_mic全部与leg_link处于同一空间位置，视觉上被遮挡，仅能看到最外层的leg_link。
2. Joint标签违规嵌套Visual元素：URDF规范中<joint>标签不支持直接添加<visual>节点，这部分内容不仅无效，还可能干扰Gazebo的解析逻辑。
3. Prismatic关节范围不合理：leg_joint的上限设为100.0，远超实际需求，初始位置为0时会让arm_link完全重叠在leg_link上。

具体修复步骤 #

1. 调整关节Origin偏移，分散连杆位置 #

给每个关节设置合理的空间偏移，让连杆按预期布局：

• base_joint：将base_link抬离地面，设置<origin xyz="0 0 0.3" rpy="0 0 0"/>
• base_spherical_joint：让leg_link从base_link上方延伸，设置<origin xyz="0 0 0.1" rpy="0 0 0"/>
• leg_joint：让arm_link从leg_link顶端起始，设置<origin xyz="0 0 0.6" rpy="0 0 0"/>
• arm_joint：设置<origin xyz="0 0 0.6" rpy="0 0 0"/>
• end_effector_joint：设置<origin xyz="0 0 0.6" rpy="0 0 0"/>

2. 删除Joint内的Visual元素 #

移除所有<joint>标签下的<visual>块，比如base_joint中的这段无效代码：

<visual>
    <geometry>
        <sphere radius="0.5"/>
    </geometry>
    <material name="blue"/>
</visual>

若需要可视化关节位置，可在对应连杆上添加额外视觉部件，或启用Gazebo自带的关节可视化选项。

3. 修正Prismatic关节范围 #

将leg_joint的上限改为合理值，比如1.0：

<limit lower="0.0" upper="1.0" effort="1000.0" velocity="1000.0" />

4. 验证URDF正确性 #

用以下命令检查URDF语法是否合规：

check_urdf your_robot.urdf

再生成结构树确认连接关系：

urdf_to_graphiz your_robot.urdf

修复后关键URDF片段示例 #

<joint name="base_joint" type="revolute">
    <parent link="world"/>
    <child link="base_link"/>
    <origin rpy="0 0 0" xyz="0 0 0.3"/>
    <axis xyz="1 0 0" />
    <safety_controller k_position="3.1416" k_velocity="1000.0" k_effort="1000.0"/>
    <calibration rising="0.0" falling="0.0"/>
    <dynamics damping="0.0" friction="0.0"/>
    <limit lower="-3.1416" upper="3.1416" effort="1000.0" velocity="1000.0" />
</joint>
<joint name="base_spherical_joint" type="revolute">
    <parent link="base_link"/>
    <child link="leg_link"/>
    <origin xyz="0 0 0.1" rpy="0 0 0"/>
    <axis xyz="1 0 0" />
    <safety_controller k_position="3.1416" k_velocity="1000.0" k_effort="1000.0"/>
    <calibration rising="0.0" falling="0.0"/>
    <dynamics damping="0.0" friction="0.0"/>
    <limit lower="-3.1416" upper="3.1416" effort="1000.0" velocity="1000.0" />
</joint>
<joint name="leg_joint" type="prismatic">
    <parent link="leg_link"/>
    <child link="arm_link"/>
    <origin xyz="0 0 0.6" rpy="0 0 0"/>
    <limit lower="0.0" upper="1.0" effort="1000.0" velocity="1000.0" />
    <safety_controller k_position="1.0" k_velocity="1000.0" k_effort="1000.0"/>
    <calibration rising="0.0" falling="0.0"/>
    <dynamics damping="0.1" friction="0.0"/>
</joint>

内容的提问来源于stack exchange，提问作者Fc0001