# MoveItPy初始化报错Failed to load any planning pipelines

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-11-11-moveit2-3968
> 频道：pitfalls | 更新日期：2026-11-11 | 标签：auto, github-issue, moveit2
> 核心摘要：MoveItPy因仅读取本地节点参数导致无法加载规划管线，需通过MoveItConfigsBuilder显式传入配置字典绕过。

# MoveItPy初始化报错Failed to load any planning pipelines

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[MoveItPy fails to get planning pipelines from parameter server](https://github.com/moveit/moveit2/issues/3968)（GitHub ros-planning/moveit2 #3968）

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

## 问题

在Ubuntu 24.04及MoveIt2 2.14.3-1二进制版本下，初始化`MoveItPy`时报错`Failed to load any planning pipelines`。尽管`ros2 param get /move_group planning_pipelines`显示参数已设置，但`MoveItPy`内部创建的节点未自动同步`/move_group`参数，且`MoveItCpp`仅读取自身节点的`planning_p。

## 环境

OS: Ubuntu 24.04; ROS: Kilted; MoveIt2: 2.14.3-1 (Binary); Python API: MoveItPy

## 解决办法

1. 使用`MoveItConfigsBuilder`构建配置对象，替代直接依赖参数服务器自动发现机制。
2. 调用`to_dict()`方法将构建好的配置转换为字典格式。
3. 在实例化`MoveItPy`时，通过`configs_dict`参数显式传入上述配置字典，确保规划管线参数被正确加载至内部节点。

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

## 原始参考来源 (Sources)

- [GitHub ros-planning/moveit2 #3968：MoveItPy fails to get planning pipelines from parameter server](https://github.com/moveit/moveit2/issues/3968)