MoveIt报"未连接TF树"警告但tf2_echo正常，原因何在？

核心原因：MoveIt的TF监听有过滤机制 #

MoveIt的planning_scene_monitor和tf2工具的逻辑不一样——tf2会遍历整个TF树查找变换，但planning_scene_monitor默认只盯着机器人URDF里定义的那些坐标系，不会主动订阅整个TF树的所有变换。哪怕你有world当公共祖先，只要它没订阅world到camera_link或者world到base的变换，就会判定这俩坐标系属于未连接的树。

另外还有个常见情况：MoveIt默认用机器人的base_link作为规划的根坐标系，不会主动去处理base_link之外的TF分支（比如world到相机的那条链），自然就找不到变换路径了。

具体排查和解决步骤 #

• 修改PlanningSceneMonitor的TF订阅设置
  找到MoveIt的启动文件（比如move_group.launch.py），调整planning_scene_monitor的参数，让它订阅所有TF话题，或者明确列出需要监听的坐标系。示例配置片段：

  tf_monitor_params = {
      "subscribe_to_all_topics": True,
      "tf_buffer_duration": 10.0
  }
  

  也可以在机器人对应的xxx_moveit_config包的config/planning_scene_monitor_config.yaml中修改相关配置。

• 将全局参考坐标系设为world
  在planning_scene_monitor_config.yaml里，把global_frame的值改成world。这样MoveIt会以world为根坐标系解析所有TF变换，base_link和相机的坐标系就能通过world完成连接。

• 检查TF的发布频率和缓存时间
  确保world→base、world→camera_link这些变换的发布频率足够（建议≥10Hz），同时确认planning_scene_monitor的TF缓存时长足够覆盖变换的历史数据，避免因缓存过期导致无法解析。

• 确认坐标系的命名空间一致
  检查机器人和相机的TF是否在同一个命名空间下，别出现一个在/robot、一个在/camera的情况。如果不在同一空间，要么统一命名空间，要么在MoveIt配置中指定正确的命名空间前缀。

补充说明 #

tf2工具（比如tf2_echo）是全量查询TF树的所有变换，而MoveIt的planning_scene_monitor出于性能和安全性考虑，只关注与机器人规划相关的坐标系，这就是两者行为差异的根本原因。

内容的提问来源于stack exchange，提问作者Frank