# franka_description加载cobot_pump夹爪可视化报错

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-08-05-franka-description-20
> 频道：pitfalls | 更新日期：2026-08-05 | 标签：auto, github-issue, franka_description
> 核心摘要：更新仓库至main分支修复URDF生成错误，并适配末端执行器xacro参数以解决cobot_pump可视化失败问题。

# franka_description加载cobot_pump夹爪可视化报错

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[Can't visualise if trying to load cobot_pump gripper](https://github.com/frankarobotics/franka_description/issues/20)（GitHub frankarobotics/franka_description #20）

**状态**：已解决

## 问题

在franka_description中尝试加载cobot_pump夹爪进行机械臂可视化时，无论搭配何种机械臂型号均抛出错误，导致模型无法正常显示。该问题源于URDF xacro文件配置缺失或过时，致使网格资源引用失败。

## 环境

ROS 2 Jazzy容器环境，franka_description仓库main分支，涉及fr3、fp3、fer、fr3v2及fr3v2_1五种机械臂型号。

## 解决办法

1. 将franka_description仓库更新至最新main分支，获取针对cobot_pump的URDF修复补丁。
2. 修改机器人URDF xacro文件，根据end_effectors文件夹下cobot_pump arguments xacro中的定义，正确适配cobot_pump相关参数。
3. 使用命令`xacro robots/<arm>/<arm>.urdf.xacro ee_id:=cobot_pump`重新生成URDF，确保所有网格（如`meshes/robot_ee/cobot_pump/visual/cobot_pump.dae`）解析成功且`check_urdf`校验通过。

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

## 原始参考来源 (Sources)

- [GitHub frankarobotics/franka_description #20：Can't visualise if trying to load cobot_pump gripper](https://github.com/frankarobotics/franka_description/issues/20)