# IsaacLab NewtonSiteFrameView在模型finalize后误判非碰撞site报。

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-10-23-isaaclab-7401
> 频道：pitfalls | 更新日期：2026-10-23 | 标签：auto, github-issue, isaaclab
> 核心摘要：NewtonSiteFrameView在sim.reset()后将合法非碰撞MJCF site误判为碰撞体致ValueError，已通过PR #7387修复。

# IsaacLab NewtonSiteFrameView在模型finalize后误判非碰撞site报。

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[[Bug] NewtonSiteFrameView rejects non-colliding MJCF sites after model finalization](https://github.com/isaac-sim/IsaacLab/issues/7401)（GitHub isaac-sim/IsaacLab #7401）

**状态**：已解决

## 问题

在IsaacLab中，通过MjcfFileCfg导入含<site>的MJCF资产后，若在sim.reset()完成Newton模型finalization之后创建NewtonSiteFrameView，会抛出ValueError并将该site错误归类为碰撞形状。

## 环境

IsaacLab (main / release/3.0.0)，Newton物理后端，MJCF资产经官方转换器导入USD，使用MjcfFileCfg与NewtonSiteFrameView接口。

## 解决办法

1. 升级IsaacLab至包含PR #7387的main分支或release/3.0.0及以上版本，该提交已修正NewtonSiteFrameView对site flags的校验逻辑。
2. 确保MJCF中的<site>定义正确（如示例中type="sphere"且无collision属性），转换后其Newton ShapeFlags应仅含SITE而不含COLLIDE_SHAPES。
3. 若暂时无法升级，可将NewtonSiteFrameView的实例化移至sim.reset()调用之前以绕过该问题，但需注意pre-finalize路径下site变换可能与Newton状态不同步。

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

## 原始参考来源 (Sources)

- [GitHub isaac-sim/IsaacLab #7401：[Bug] NewtonSiteFrameView rejects non-colliding MJCF sites after model finalization](https://github.com/isaac-sim/IsaacLab/issues/7401)