# MoveIt Setup Assistant加载Unitree G1 URDF配置时崩溃

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-01-27-unitree-ros-137
> 频道：pitfalls | 更新日期：2026-01-27 | 标签：auto, github-issue, unitree_ros
> 核心摘要：G1官方URDF在MoveIt Setup Assistant中加载崩溃，社区提供适配MoveIt2的G1机械臂操作仓库作为替代方案。

# MoveIt Setup Assistant加载Unitree G1 URDF配置时崩溃

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[Crash in MoveIt Setup Assistant when loading Unitree G1 URDF for configuration](https://github.com/unitreerobotics/unitree_ros/issues/137)（GitHub unitreerobotics/unitree_ros #137）

**状态**：有绕过办法

## 问题

使用Unitree G1官方.urdf和mesh文件创建ROS 2包后，RViz2可视化正常，但在MoveIt Setup Assistant中点击Load配置G1轨迹规划时程序立即崩溃报错；相同环境下panda_demo运行正常，表明问题特定于G1模型描述文件与MoveIt兼容性。

## 环境

Unitree G1机器人，ROS 2，MoveIt 2，官方.urdf及mesh文件，RViz2

## 解决办法

1. 确认当前使用的官方URDF可能仅适配MuJoCo仿真而非MoveIt规划，需检查URDF中link/joint定义是否符合MoveIt解析规范
2. 参考社区已验证的G1 MoveIt2适配仓库 https://github.com/sharan05032000/Unitree-G1-MoveIt2-Arm-Manipulation.git ，直接使用其修改后的URDF与配置文件
3. 若需自行修复，应检查URDF中是否存在未闭合标签、非法惯性参数或缺失collision几何体等导致MoveIt解析器崩溃的元素

讨论原作者：@forever-cover 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub unitreerobotics/unitree_ros #137：Crash in MoveIt Setup Assistant when loading Unitree G1 URDF for configuration](https://github.com/unitreerobotics/unitree_ros/issues/137)