4、ROS2与Gazebo桥接：ros_gz_bridge的安装与配置、话题映射、服务映射

好，咱们进入正题。ROS2和Gazebo之间怎么通信？说白了，就是靠一个叫ros_gz_bridge的桥梁。我最早接触这个桥接时，也踩过不少坑，今天就把我的经验全盘托出。

4.1 为什么需要桥接？

你想想看，ROS2有自己的话题、服务、动作机制，Gazebo仿真器也有自己的一套通信协议。它们俩就像两个说不同语言的人，没法直接聊天。ros_gz_bridge就是那个翻译官，负责把ROS2的消息转成Gazebo能懂的格式，反过来也一样。

我在项目中遇到过最典型的情况：用ROS2的导航栈控制机器人，但仿真环境在Gazebo里跑。没有桥接，你发的/cmd_vel指令根本到不了仿真模型。嗯，这个问题当年困扰了我整整一个下午。

4.2 安装ros_gz_bridge

安装其实很简单，但要注意版本匹配。ROS2和Gazebo的版本必须对应好，否则桥接会报一些莫名其妙的错误。

⚠️ 版本匹配警告： ROS2 Humble 对应 Gazebo Fortress（Ignition Fortress），ROS2 Iron 对应 Gazebo Harmonic。千万别搞混了。

我个人习惯用二进制安装，省事又稳定：

# 安装 ros_gz_bridge（以ROS2 Humble + Gazebo Fortress为例）
sudo apt install ros-humble-ros-gz-bridge

# 验证安装是否成功
ros2 pkg list | grep ros_gz_bridge

如果看到输出里有ros_gz_bridge，那就说明装好了。我记得第一次装完，心里还挺美，觉得万事大吉了。结果一跑起来，发现话题根本没通……后来才意识到，光装包不够，还得配置映射关系。

4.3 话题映射：核心配置

话题映射，就是告诉桥接器：ROS2的哪个话题对应Gazebo的哪个话题。格式很简单：

# 基本格式
ros_topic@gz_topic@message_type

举个例子，把ROS2的/cmd_vel映射到Gazebo的/model/vehicle/cmd_vel：

ros2 run ros_gz_bridge parameter_bridge /cmd_vel@geometry_msgs/msg/Twist@gz.msgs.Twist

这里有个小细节：@符号分隔了三部分——ROS2话题、ROS2消息类型、Gazebo消息类型。我刚开始总记不住顺序，后来干脆写了个脚本模板，每次改改参数就行。

💡 我的小技巧： 用YAML文件管理所有映射关系，启动时一次性加载。这样改起来方便，也容易复用。

YAML配置示例：

# bridge_config.yaml
- ros_topic_name: "/cmd_vel"
  gz_topic_name: "/model/vehicle/cmd_vel"
  ros_type_name: "geometry_msgs/msg/Twist"
  gz_type_name: "gz.msgs.Twist"
  direction: BIDIRECTIONAL

- ros_topic_name: "/odom"
  gz_topic_name: "/model/vehicle/odometry"
  ros_type_name: "nav_msgs/msg/Odometry"
  gz_type_name: "gz.msgs.Odometry"
  direction: GZ_TO_ROS

启动时这样加载：

ros2 run ros_gz_bridge parameter_bridge --ros-args -p config_file:=./bridge_config.yaml

为什么要用BIDIRECTIONAL（双向）？因为有些话题需要两边都能发，比如/cmd_vel是ROS2发给Gazebo，而/odom是Gazebo发给ROS2。方向搞反了，数据就流不过去。我曾经因为这个排查了半天，最后发现是direction写错了……

4.4 服务映射

除了话题，服务也能桥接。不过服务的映射比话题稍微复杂一点，因为服务有请求和响应两个部分。

举个例子，Gazebo里有个/world/default/create服务，用来创建模型。你想从ROS2端调用它，就得做服务映射：

ros2 run ros_gz_bridge parameter_bridge /create@std_srvs/srv/Empty@gz.msgs.Empty

但说实话，服务映射在实际项目中用得不多。我个人习惯把复杂的服务调用封装成ROS2节点，在节点内部通过Gazebo的C++ API直接操作。这样更灵活，也更容易调试。

🔑 核心要点： 话题映射是日常主力，服务映射用于特殊场景。先掌握话题映射，再根据需要学习服务映射。

4.5 实战：一个完整的桥接示例

咱们来个完整的例子。假设你有一个差速驱动机器人，需要把ROS2的速度指令发给Gazebo，同时接收里程计数据。

第一步，启动Gazebo仿真环境：

gz sim empty.sdf

第二步，启动桥接器：

ros2 run ros_gz_bridge parameter_bridge \
  /cmd_vel@geometry_msgs/msg/Twist@gz.msgs.Twist \
  /odom@nav_msgs/msg/Odometry@gz.msgs.Odometry

第三步，在ROS2端发布速度指令：

ros2 topic pub /cmd_vel geometry_msgs/msg/Twist "{linear: {x: 0.5}, angular: {z: 0.1}}"

这时候，你应该能看到Gazebo里的机器人开始移动了。同时，用ros2 topic echo /odom可以实时看到里程计数据。

嗯，这里要注意：如果机器人没动，先检查话题名称是否匹配。我遇到过好几次，Gazebo里模型的名字和话题名对不上，导致指令发过去了但没人接收。

4.6 知识体系总览

下面这张图，是我自己总结的ros_gz_bridge核心逻辑。你看一眼，心里就有数了：

ROS2 话题：/cmd_vel 话题：/odom 服务：/spawn 服务：/delete Gazebo /model/vehicle/cmd_vel /model/vehicle/odometry /world/default/create /world/default/remove ros_gz_bridge 话题映射 服务映射 参数配置 YAML / 命令行 双向数据流（BIDIRECTIONAL） ROS2 → Gazebo：指令下发 Gazebo → ROS2：状态反馈

这张图很直观：ROS2和Gazebo各自维护自己的话题/服务命名空间，桥接器负责在中间做翻译和转发。配置好映射关系后，两边就能无缝通信了。

4.7 常见问题与避坑

  • 话题不通？ 先检查桥接器是否启动，再用ros2 topic list和gz topic -l分别查看两边的话题列表，看映射是否生效。
  • 消息类型不匹配？ 这是最坑的。ROS2的Twist和Gazebo的Twist虽然名字一样，但字段定义可能不同。一定要用ros2 interface show和gz msg -i对比确认。
  • 性能问题？ 如果数据量太大，桥接器会成为瓶颈。我建议用--qos参数调整QoS策略，比如降低频率或使用Best Effort模式。
⚠️ 我曾经踩过的坑： 有一次在项目中，桥接器启动后一切正常，但跑了半小时后突然断连。排查了半天，发现是Gazebo的QoS设置和ROS2不匹配，导致订阅超时。后来统一改成--qos 1（Reliable）才解决。

好了，关于ros_gz_bridge的安装、配置、话题映射和服务映射，就讲到这里。记住一个原则：先确认版本匹配，再配置映射关系，最后测试双向通信。按这个流程走，基本不会出大问题。

可可精品资料库

← 上一章 📖 返回目录 下一章 →