ROS2 Galactic操控KUKA iiwa14时Rviz报world帧不存在无tf数据错误

报错现象 #

Rviz无法加载机器人模型，Global Status栏显示Warn级别告警：Fixed Frame No tf data. Actual error: Frame [world] does not exist
Rviz报错界面截图

排查与解决步骤 #

• 校验TF链路完整性
  执行命令检查是否有节点正常发布包含world帧的TF数据：
  ros2 run tf2_tools view_frames
  命令执行完成后会在当前运行目录生成frames.pdf文件，打开查看TF树结构，正常链路以world为根节点，串联iiwa机器人所有link；也可执行实时话题监听命令确认TF消息输出状态：
  ros2 topic echo /tf
ros2 topic echo /tf_static
  若输出内容中无world帧相关变换信息，说明TF发布环节异常。

• 核对启动命令与参数
  该类突发问题多由启动时参数缺失、工作空间未正确source导致。iiwa_ros2 Galactic版本全链路启动命令如下：
  实物控制场景：
  ros2 launch iiwa_bringup iiwa.launch.py use_sim:=false robot_model:=iiwa14
  仿真场景：
  ros2 launch iiwa_bringup iiwa.launch.py use_sim:=true robot_model:=iiwa14
  注意：漏传robot_model参数、参数值填写错误、启动前未source工作空间install/setup.bash，都会导致robot_state_publisher节点加载URDF失败，无法发布完整TF树。

• 检查robot_state_publisher节点运行状态
  执行命令确认机器人状态发布节点存活状态：
  ros2 node list | grep robot_state_publisher
  若命令无对应输出，说明节点未成功启动，查看启动终端日志定位问题，常见故障为xacro编译失败、URDF文件路径解析错误，可重新编译相关功能包后重试：
  colcon build --packages-select iiwa_description iiwa_bringup --symlink-install
  编译完成后重新source工作空间环境，再执行启动命令。

• 临时补全TF快速恢复
  若确认仅缺失world到机器人基坐标系的静态变换，可直接执行命令手动发布静态TF快速恢复，无需修改功能包源码：
  ros2 run tf2_ros static_transform_publisher 0 0 0 0 0 0 world iiwa_link_0
  执行后Rviz告警将自动消除，机器人模型正常加载。

• 修复Rviz配置异常
  若TF链路完全正常但告警依旧存在，为本地保存的Rviz配置损坏导致，直接调用功能包自带默认Rviz配置启动即可规避自定义配置错误：
  ros2 launch iiwa_bringup iiwa_rviz.launch.py
  启动后确认Global Options下的Fixed Frame参数选中world即可。

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