# GR00T_N1微调报错TypeError: cannot pickle mappingproxy

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-11-18-isaac-gr00t-88
> 频道：pitfalls | 更新日期：2026-11-18 | 标签：auto, github-issue, isaac-gr00t
> 核心摘要：旧版GR00T N1嵌套配置导致序列化失败，升级至N1.7版本使用扁平化配置并锁定transformers==4.57.3即可解决。

# GR00T_N1微调报错TypeError: cannot pickle mappingproxy

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[TypeError: cannot pickle 'mappingproxy' object during GR00T_N1.from_pretrained()](https://github.com/NVIDIA/Isaac-GR00T/issues/88)（GitHub NVIDIA/Isaac-GR00T #88）

**状态**：已解决

## 问题

在调用 `GR00T_N1.from_pretrained()` 进行模型微调时，`transformers` 库对嵌套配置执行 `copy.deepcopy` 触发 `TypeError: cannot pickle 'mappingproxy' object`。该错误源于旧版代码重写加载方法并向 `transformers` 4.45 传递了不支持序列化的嵌套配置结构。

## 环境

Python 3.10, transformers 4.45, NVIDIA Isaac-GR00T (旧版 GR00T N1)

## 解决办法

1. 将 Isaac-GR00T 仓库更新至包含 N1.6/N1.7 重构的最新 `main` 分支，弃用旧版 `gr00t/model/gr00t_n1.py` 代码路径。
2. 确保环境依赖中 `transformers` 版本锁定为 `4.57.3`，新版已采用标准 `Gr00tN1d7Config` 扁平配置且无自定义 `from_pretrained` 覆写。
3. 使用新版单卡微调脚本验证修复：运行 `CUDA_VISIBLE_DEVICES=0 uv run python gr00t/experiment/launch_finetune.py --base-model-path nvidia/GR00T-N1.7-3B --dataset-path demo_data/cube_to_bowl_5 --embodiment-tag NEW_EMBODIMENT --modality-config-path examples/SO100/so100_config.py --n…

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

## 原始参考来源 (Sources)

- [GitHub NVIDIA/Isaac-GR00T #88：TypeError: cannot pickle 'mappingproxy' object during GR00T_N1.from_pretrained()](https://github.com/NVIDIA/Isaac-GR00T/issues/88)