# franka_ros2启动报错Parameter version is not set及接口缺失

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-06-01-franka-ros2-135
> 频道：pitfalls | 更新日期：2026-06-01 | 标签：auto, github-issue, franka_ros2
> 核心摘要：franka_ros2因URDF缺少version参数致硬件初始化失败，可回退至v1.0.0标签或手动修复xacro文件解决。

# franka_ros2启动报错Parameter version is not set及接口缺失

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[Parameter '' is not set. Please update your URDF (aka franka_description).](https://github.com/frankarobotics/franka_ros2/issues/135)（GitHub frankaemika/franka_ros2 #135）

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

## 问题

运行 `move_to_start_example_controller.launch.py` 时，`ros2_control_node` 报 FATAL 错误 `Parameter 'version' is not set.

## 环境

Franka FR3 (arm_id:=fr3)，franka_ros2 humble 分支（含 commit ac4e343），ROS 2 Humble，Linux 系统。

## 解决办法

1. 推荐方案：将 `franka_ros2` 仓库切换至稳定标签 `v1.0.0`，避开 humble 分支当前 URDF 兼容性问题；注意 v1.0.0 存在 `franka_robot_state_broadcaster` 日志刷屏但不影响控制。
2. 替代方案：若必须使用新版，需更新 `franka_description` 包使其包含 `version` 参数，或使用社区 fork 版本（如 danielsanjosepro/franka_ros2）作为临时过渡。
3. 手动修复：定位 `install/franka_description/share/franka_description/robots/common/franka_arm.ros2_control.xacro`，在 `<xacro:if>` 标签下补充缺失的 `version` 参数定义，确保与 `FrankaHardwareInterface` 期望一致。
4. 验证：重新编译工作空间后再次启动 launch…

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

## 原始参考来源 (Sources)

- [GitHub frankaemika/franka_ros2 #135：Parameter '' is not set. Please update your URDF (aka franka_description).](https://github.com/frankarobotics/franka_ros2/issues/135)