# MuJoCo>=3.4.0致LIBERO task5初始状态碗未归位

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-11-13-lerobot-4390
> 频道：pitfalls | 更新日期：2026-11-13 | 标签：auto, github-issue, lerobot
> 核心摘要：MuJoCo>=3.4.0物理引擎变更导致LIBERO task5重置时碗无法正确落入ramekin，需将依赖版本严格锁定在3.4.0以下。

# MuJoCo&gt;=3.4.0致LIBERO task5初始状态碗未归位

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[mujoco&gt;=3.4.0 silently breaks the initial-state premise of libero_spatial task 5 (bowl no longer seats on the ramekin during reset), and the current pin &lt;3.9.0 does not guard against it](https://github.com/huggingface/lerobot/issues/4390)（GitHub huggingface/lerobot #4390）

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

## 问题

在LeRobot中使用LIBERO spatial task 5时，若MuJoCo版本&gt;=3.4.0，`env.reset()`内的物理沉降（settle）行为异常。原本应落在ramekin中的黑碗变为倾斜搁置在边缘或悬空，导致任务初始前提被破坏。

## 环境

LeRobot 0.6.0/0.6.1, Linux x86_64, Python 3.12, PyTorch 2.11+cu130, NVIDIA A800; MuJoCo 3.4.0/3.8.1/3.12.0复现, 3.3.7正常; robosuite 1.4.1

## 解决办法

1. 修改项目依赖配置，将MuJoCo版本严格锁定为`mujoco<3.4.0`（推荐3.3.7），避免pip自动解析到3.4.0至3.8.x的故障版本区间。
2. 若使用LeRobot官方libero extra，需等待或手动应用PR #4465中的版本约束补丁，确保hf-libero依赖同步收紧。
3. 验证修复效果：运行社区提供的`mj_settle_probe.py`脚本，加载task 5的50个官方初始状态并settle 250步，确认bowl-ramekin xy位移恢复至约1.45cm（3.3.7基准值），而非故障版的3.72cm以上。
4. 注意MuJoCo 3.12.0重写了box-box collider，虽修复了部分穿透问题但task 5偏移量变为6.23cm，当前阶段仍不建议升级至3.12+。

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

## 原始参考来源 (Sources)

- [GitHub huggingface/lerobot #4390：mujoco>=3.4.0 silently breaks the initial-state premise of libero_spatial task 5 (bowl no longer seats on the ramekin during reset), and the current pin <3.9.0 does not guard against it](https://github.com/huggingface/lerobot/issues/4390)