# franka_ros2 Humble源码编译缺失controller_interface/helpe。

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-06-01-franka-ros2-160
> 频道：pitfalls | 更新日期：2026-06-01 | 标签：auto, github-issue, franka_ros2
> 核心摘要：ROS2 Humble更新后franka_semantic_components编译失败，需手动安装或回退ros-humble-controller-interface包解决头文件缺失。

# franka_ros2 Humble源码编译缺失controller_interface/helpe。

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[package franka_semantic_components and franka_robot_state_broadcaster build failed from source with humble version](https://github.com/frankarobotics/franka_ros2/issues/160)（GitHub frankaemika/franka_ros2 #160）

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

## 问题

在Ubuntu 22.04与ROS2 Humble环境下从humble分支源码构建franka_ros2时，franka_semantic_components和franka_robot_state_broadcaster报错fatal error: controller_interface/helpers.

## 环境

OS: Ubuntu 22.04; ROS: Humble; Branch: humble; Package: franka_ros2 (franka_semantic_components, franka_robot_state_broadcaster)

## 解决办法

1. 确认系统已执行`sudo apt update && sudo apt upgrade`且复现了头文件路径变更导致的编译错误。
2. 针对缺失的`controller_interface/helpers.hpp`，手动安装兼容版本的`ros-humble-controller-interface`包或从ros2_control对应tag源码编译安装以恢复旧版头文件结构。
3. 若使用Docker构建，需在Dockerfile中显式指定`ros-humble-controller-interface`的版本号或添加源码编译步骤，避免apt自动拉取不兼容的新版头文件。
4. 重新执行`source package/install/local_setup.bash`并运行`colcon build`验证编译通过。

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

## 原始参考来源 (Sources)

- [GitHub frankaemika/franka_ros2 #160：package franka_semantic_components and franka_robot_state_broadcaster build failed from source with humble version](https://github.com/frankarobotics/franka_ros2/issues/160)