1. 项目概述跨越ROS版本的数据回放挑战如果你是从ROS1“古早”版本一路摸爬滚打过来的机器人开发者手头肯定攒了一堆宝贵的.bag数据文件。这些bag包可能是当年调试SLAM算法时小车在实验室里磕磕绊绊跑了几十圈才录下来的点云和里程计也可能是某个已经退役的传感器留下的唯一一批校准数据。当团队决定将项目迁移到ROS2时一个非常现实且棘手的问题就摆在了面前这些记录了历史、承载了调试心血的ROS1 bag包难道就只能在ROS1环境下“养老”无法在新的ROS2生态中发挥余热了吗当然不是。rosbag_v2正是为解决这一痛点而生的工具。它不是一个独立的全新录包工具而是一个精巧的“转译器”和“播放器”。其核心使命是让你能够在纯ROS2的环境中直接读取、解析并回放ROS1格式的bag包将里面的话题数据原汁原味地或经过必要转换后发布到ROS2的DDS网络上。这意味着你那些用rosbag record录制的旧数据可以直接用来测试新的ROS2节点、验证算法移植后的正确性或者进行新旧系统的对比实验而无需折腾双系统、双ROS版本并行运行这种繁琐的操作。这个方法特别适合那些正在从ROS1向ROS2过渡的团队和个人。无论是评估迁移效果、复用历史数据训练模型还是单纯地不想丢掉过去的调试记录rosbag_v2都提供了一个相对平滑的桥梁。它省去了数据转换的中间步骤实现了“即开即用”式的回放对于提升开发调试效率有着实实在在的帮助。2. 核心原理与方案选型为什么是rosbag_v2在深入实操之前我们有必要拆解一下rosbag_v2的工作原理这能帮助我们在后面遇到问题时更快地定位根源。ROS1和ROS2在底层架构上存在代际差异最大的鸿沟在于中间件ROS1基于自定义的TCPROS/UDPROS而ROS2基于标准的DDS数据分发服务。这导致它们的话题消息、序列化方式乃至时间系统都不直接兼容。rosbag_v2方案的本质是在ROS2环境中创建一个“兼容层”。这个方案通常依赖于ros1_bridge这个关键组件。ros1_bridge是一个双向的、动态的桥接器它能在同一台机器的ROS1和ROS2网络之间自动转发话题和服务。而rosbag_v2回放ROS1 bag包的典型工作流如下启动ROS1核心虽然我们的目标是ROS2环境但为了解析ROS1的bag文件需要先启动一个ROS1的roscore。这个roscore运行在后台不干扰ROS2的DDS网络仅为bag文件解析提供必要的ROS1环境上下文。启动ros1_bridge接着启动ros1_bridge。它会监测指定的、或所有的话题。当有数据从ROS1侧发布时桥会自动将其转换为ROS2的消息类型并转发到ROS2网络反之亦然。使用rosbag play (ROS1版本)在已经拥有ROS1环境通过第一步的roscore的终端里使用传统的rosbag play命令播放你的ROS1 bag包。此时bag包中的数据会以ROS1话题的形式发布出来。桥接转发ros1_bridge捕获到这些ROS1话题的数据流实时地进行消息类型转换如果存在直接映射或通过自定义转换规则然后将转换后的数据以同名的或按规则重命名的ROS2话题发布出去。ROS2节点订阅你的ROS2应用程序无论是Rviz2、导航栈节点还是自定义算法节点此时就可以像订阅普通ROS2话题一样订阅这些由桥转发过来的数据从而实现回放。那么为什么不直接把bag包转换成ROS2格式呢确实存在离线转换工具如rosbag2的转换功能但对于复杂的、含有自定义消息类型的bag包离线转换可能需要编写大量的消息转换插件过程繁琐且容易出错。rosbag_v2这种“在线桥接播放”的方案优势在于动态性和灵活性。它利用了ros1_bridge的实时转换能力特别适合快速验证和调试。你不需要为所有消息类型预先写好转换器ros1_bridge对于ROS标准消息如sensor_msgs/Image,nav_msgs/Odometry等有内置支持对于自定义消息也提供了生成转换接口的方法。注意这种方法并非完美。它要求系统同时安装ROS1和ROS2并且需要同时运行两者的核心程序对系统资源有一定占用。此外实时桥接会引入微小的延迟对于极高频率或严格实时性要求的场景需要谨慎评估。但对于绝大多数调试、算法验证和数据复现场景其便利性远大于这些微小代价。3. 环境准备与安装部署工欲善其事必先利其器。要让rosbag_v2跑起来你的系统必须是一个同时包含ROS1和ROS2的“混合环境”。下面以Ubuntu 20.04 (ROS1 Noetic ROS2 Foxy) 和 Ubuntu 22.04 (ROS1 可安装Noetic ROS2 Humble) 为例给出详细的准备步骤。这里假设你已经有了一个ROS1的bag包。3.1 基础系统与ROS1环境确认首先确保你的ROS1环境是完好可用的。# 检查ROS1环境是否已配置 source /opt/ros/noetic/setup.bash # 根据你的ROS1版本调整如melodic, kinetic等 printenv | grep ROS你应该能看到ROS_VERSION1和ROS_DISTROnoetic等变量。尝试运行roscore确保能正常启动。这是后续所有步骤的基石。3.2 ROS2环境安装与配置如果你还没有安装ROS2需要先进行安装。以ROS2 Humble对应Ubuntu 22.04为例# 1. 设置语言环境 locale # 检查是否支持UTF-8 sudo apt update sudo apt install locales sudo locale-gen en_US en_US.UTF-8 sudo update-locale LC_ALLen_US.UTF-8 LANGen_US.UTF-8 export LANGen_US.UTF-8 # 2. 添加ROS2软件源 sudo apt install software-properties-common sudo add-apt-repository universe sudo apt update sudo apt install curl -y sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release echo $UBUNTU_CODENAME) main | sudo tee /etc/apt/sources.list.d/ros2.list /dev/null # 3. 安装ROS2桌面版推荐包含Rviz2、示例等 sudo apt update sudo apt install ros-humble-desktop # 4. 配置环境变量 source /opt/ros/humble/setup.bash echo “source /opt/ros/humble/setup.bash” ~/.bashrc # 可选添加到bashrc安装完成后新开一个终端测试ROS2基础功能source /opt/ros/humble/setup.bash ros2 run demo_nodes_cpp talker在另一个终端运行ros2 run demo_nodes_py listener应该能看到消息打印。3.3 关键组件ros1_bridge的编译安装ros1_bridge是连接两个世界的核心。虽然有些ROS2桌面版安装包可能包含了预编译的ros1_bridge但为了确保兼容性和功能完整特别是需要支持自定义消息时从源码编译是更可靠的做法。编译它需要一个同时能“看到”ROS1和ROS2的工作空间。# 1. 创建一个用于桥接的专属工作空间例如名为bridge_ws mkdir -p ~/bridge_ws/src cd ~/bridge_ws/src # 2. 克隆ros1_bridge源码 git clone https://github.com/ros2/ros1_bridge.git -b humble # 请将‘humble’替换为你的ROS2版本 # 3. 克隆示例代码包含测试消息定义可选但推荐 git clone https://github.com/ros2/example_interfaces.git git clone https://github.com/ros2/rcl_interfaces.git # 4. 配置工作空间关键步骤是同时source ROS1和ROS2的环境 cd ~/bridge_ws source /opt/ros/noetic/setup.bash # 先source ROS1 source /opt/ros/humble/setup.bash # 再source ROS2 # 5. 检查环境确保两个版本都存在 printenv | grep ROS_VERSION # 应该能看到ROS_VERSION1和ROS_VERSION2都被设置过当前生效的是2 # 6. 安装依赖并编译 sudo apt update sudo apt install python3-colcon-common-extensions -y colcon build --symlink-install --packages-select ros1_bridge --cmake-force-configure编译过程可能会花费一些时间因为它需要为所有已知的公共消息类型生成桥接代码。编译成功后你会在install目录下找到相关的库和可执行文件。实操心得编译ros1_bridge最常见的问题是环境变量冲突。务必遵循“先ROS1后ROS2”的source顺序。编译完成后使用这个工作空间时也需要按相同顺序sourcesource /opt/ros/noetic/setup.bash; source ~/bridge_ws/install/setup.bash注意此时通常不需要再显式source ROS2的setup.bash因为bridge工作空间的setup.bash会继承并覆盖所需环境。如果遇到关于消息类型的错误可能是你的ROS1或ROS2缺少某些消息包请根据错误提示使用apt或rosdep安装。4. 完整实操流程一步步回放你的ROS1 bag包假设我们有一个ROS1的bag包my_old_data.bag里面录制了/scan激光雷达和/odom里程计话题。我们的目标是在ROS2中回放它并用Rviz2进行可视化。4.1 第一步启动ROS1核心roscore打开第一个终端Terminal 1这个终端将专门负责ROS1侧的服务。# Terminal 1 source /opt/ros/noetic/setup.bash roscore保持这个终端运行你会看到熟悉的ROS1 master启动日志。4.2 第二步启动动态话题桥接器ros1_bridge打开第二个终端Terminal 2这里我们需要启动编译好的ros1_bridge。为了高效我们通常以“动态桥接”模式启动让它只转发我们感兴趣的话题而不是全部话题以减少开销。# Terminal 2 # 首先按顺序source环境 source /opt/ros/noetic/setup.bash source ~/bridge_ws/install/setup.bash # 这里包含了bridge和ROS2环境 # 启动动态桥接 ros2 run ros1_bridge dynamic_bridgedynamic_bridge启动后它会静静地等待监控ROS1和ROS2网络上的话题。当有话题在任意一侧出现时它会自动尝试为其创建桥接。4.3 第三步播放ROS1 bag包打开第三个终端Terminal 3在这里使用ROS1的工具播放bag包。关键点这个终端的环境变量必须只包含ROS1不能有ROS2否则rosbag命令可能会因为环境混合而出错。# Terminal 3 # 确保这是一个纯净的ROS1环境。如果之前source过ROS2请新开一个终端或重新登录。 source /opt/ros/noetic/setup.bash # 查看bag包信息 rosbag info my_old_data.bag # 开始播放bag包。使用--loop可以循环播放便于调试。 rosbag play my_old_data.bag --clock这里--clock参数非常重要它会发布/clock话题来模拟时间。ROS2的许多节点如TF2依赖于一个统一的时间源发布时钟可以确保时间系统的一致性。当rosbag play开始后你会在Terminal 3看到播放进度。同时在Terminal 2运行dynamic_bridge的终端中你应该能看到类似下面的日志输出Created 1to2 bridge for topic /scan with ROS2 type sensor_msgs/msg/LaserScan Created 1to2 bridge for topic /odom with ROS2 type nav_msgs/msg/Odometry Created 1to2 bridge for topic /clock with ROS2 type rosgraph_msgs/msg/Clock这表明桥接器已经成功检测到了ROS1的话题并为其创建了通往ROS2的桥梁。4.4 第四步在ROS2中验证与可视化现在打开第四个终端Terminal 4进入纯ROS2环境来验证数据是否成功过来了。# Terminal 4 source /opt/ros/humble/setup.bash # 或你的ROS2版本 # 查看当前ROS2网络中的话题列表 ros2 topic list你应该能在列表中看到/scan、/odom和/clock。这些话题现在已经是地道的ROS2话题了。# 查看某个话题的数据流确认数据正在发布 ros2 topic echo /odom --once | head -20 # 查看前20条消息概览最后启动Rviz2进行可视化# Terminal 4 (继续) rviz2在Rviz2中将Fixed Frame设置为你的机器人坐标系例如odom或base_link具体取决于bag包内容。点击Add添加一个LaserScan显示将Topic设置为/scan。再添加一个TF显示查看坐标系变换。 如果bag包里包含了TF数据并且播放时使用了--clock你应该能在Rviz2中看到激光扫描数据并且TF树也是正常的。至此你已经成功地在ROS2环境中回放了ROS1的bag包。5. 进阶技巧与自定义消息处理上面的流程适用于ROS标准消息。但实际项目中大量使用的是自定义消息。当bag包里包含自定义消息时dynamic_bridge无法自动识别和转换你会看到桥接日志报错“Could not determine the type for topic ...”。这时就需要我们手动为这些自定义消息生成桥接支持。5.1 为自定义消息创建桥接假设你在ROS1中有一个自定义消息包my_pkg其中定义了MyCustomMsg.msg。在ROS2中你有一个功能对等的包my_pkg_v2定义了相同的MyCustomMsg。核心思想你需要让ros1_bridge在编译时知道这一对消息类型的映射关系。准备消息包确保你的ROS1自定义消息包和ROS2自定义消息包都已在其各自的工作空间中成功编译。并且消息的定义必须完全一致字段名、字段类型、顺序。这是桥接能成功的前提。修改桥接工作空间的src进入之前编译ros1_bridge的~/bridge_ws/src目录。cd ~/bridge_ws/src克隆或链接你的自定义消息包你需要将ROS1和ROS2版本的自定义消息包源码都放到这个src目录下。可以通过git clone或创建软链接的方式。# 假设你的ROS1消息包路径是 ~/ros1_ws/src/my_pkg # 假设你的ROS2消息包路径是 ~/ros2_ws/src/my_pkg_v2 ln -s ~/ros1_ws/src/my_pkg . ln -s ~/ros2_ws/src/my_pkg_v2 .重新编译ros1_bridge在编译时ros1_bridge的CMake脚本会自动扫描src目录下所有的ROS1和ROS2包并为找到的同名且同结构的消息生成桥接代码。cd ~/bridge_ws # 再次按顺序source环境 source /opt/ros/noetic/setup.bash source /opt/ros/humble/setup.bash # 清理旧编译结果可选但推荐 rm -rf build/ install/ log/ # 重新编译这次会包含你的自定义包 colcon build --symlink-install --packages-select ros1_bridge --cmake-force-configure验证编译成功后重新运行dynamic_bridge并播放包含自定义消息的bag包。此时桥接器应该能成功创建转换桥例如Created 1to2 bridge for topic /custom_data with ROS2 type my_pkg_v2/msg/MyCustomMsg5.2 性能优化与参数调整回放大型bag包或高频数据时可能会遇到性能瓶颈或数据丢失。可以尝试以下调整限制桥接话题如果bag包话题很多但只关心其中几个可以在启动dynamic_bridge时指定话题白名单避免不必要的转换开销。ros2 run ros1_bridge dynamic_bridge --bridge-all-topics false --topic /scan --topic /odom调整rosbag play参数-r 2以2倍速播放加快测试。-d 5在开始播放前延迟5秒给桥接器和订阅者足够的启动时间。--pause启动时暂停方便你手动在Rviz2中做好所有配置后再按空格键开始播放。使用静态桥接对于已知的、固定的消息类型集合可以编译一个静态桥接器性能比动态桥接更好。这需要在ros1_bridge包的CMakeLists.txt中配置要桥接的具体消息类型对然后编译出一个专用的静态桥接节点。这更复杂适合消息类型稳定后的生产环境。6. 常见问题排查与实战避坑指南在实际操作中你几乎一定会遇到一些问题。下面是我踩过坑后总结的常见问题及解决方法。6.1 桥接器没有创建话题桥现象rosbag play启动了但dynamic_bridge终端没有任何“Created ... bridge”的日志ROS2的ros2 topic list里也看不到话题。排查环境隔离确保播放bag包的终端Terminal 3是纯ROS1环境。用echo $ROS_VERSION检查必须为1。如果混入了ROS2环境rosbag play可能无法正确与ROS1的roscore通信。网络配置检查ROS_MASTER_URI。在Terminal 1 (roscore终端) 和 Terminal 3 (rosbag play终端)echo $ROS_MASTER_URI应该指向同一个地址通常是http://localhost:11311。ROS2侧不关心这个变量。桥接器状态在dynamic_bridge终端按几次回车看是否有反应。有时日志被缓冲了。也可以尝试增加日志级别ros2 run ros1_bridge dynamic_bridge --ros-args --log-level debug。6.2 消息类型不匹配错误现象桥接器日志显示“Could not determine the type for topic X”或“No template specialization for ...”。排查标准消息即使是标准消息也可能因为ROS1和ROS2的包命名细微差别而出错。确保你的ROS2环境安装了对应的消息包如ros-humble-sensor-msgs。自定义消息这是最常见的原因。严格按照5.1节的步骤操作。最关键的是消息定义必须完全一致。使用rosmsg show(ROS1) 和ros2 interface show(ROS2) 仔细对比两个消息的定义一个标点符号都不能差。编译清理在重新添加自定义消息包后务必彻底清理bridge_ws下的build,install,log目录再重新编译避免旧缓存干扰。6.3 Rviz2中看不到数据/TF树错误现象话题列表里有数据但Rviz2中激光扫描不显示或者TF显示No transform available。排查时钟这是最可能的原因务必在rosbag play时加上--clock参数。ROS2的TF2强烈依赖一个统一的时间源。没有时钟许多基于时间的插件无法工作。Fixed Frame检查Rviz2左上角的Fixed Frame设置是否正确。它应该设置为bag包中TF树的根坐标系通常是odom或map。你可以通过ros2 topic echo /tf_static或ros2 run tf2_ros tf2_monitor来查看可用的TF帧。数据频率有些显示插件如LaserScan有“Deadline”设置。如果bag包数据频率很低可以尝试在Rviz2的显示属性中将Decay Time调大。6.4 性能问题与数据丢失现象回放时CPU占用率高或者ROS2端接收到的消息序列不连续有丢失。优化桥接模式从动态桥切换为静态桥接能显著提升性能。播放速率尝试用-r 0.5半速播放给系统更长的处理时间。话题过滤如果bag包里有你不需要的高频话题如图像可以在rosbag play时使用--topics参数只播放需要的几个话题或者用rosbag filter事先处理bag包。系统资源关闭不必要的图形界面和其他占用资源的程序。桥接和消息转换是CPU密集型操作。6.5 一个终端命令清单为了方便操作你可以将以下命令保存为脚本。但请注意由于环境变量管理复杂更推荐按步骤在不同终端手动执行。#!/bin/bash # 这是一个概念性脚本演示流程。实际使用请分终端执行。 # 终端1: ROS1 Core # source /opt/ros/noetic/setup.bash # roscore # 终端2: 动态桥接 (需要先source ROS1再source bridge_ws) # source /opt/ros/noetic/setup.bash # source ~/bridge_ws/install/setup.bash # ros2 run ros1_bridge dynamic_bridge # 终端3: 播放ROS1 bag (纯净ROS1环境) # source /opt/ros/noetic/setup.bash # rosbag play my_old_data.bag --clock --loop # 终端4: ROS2可视化 # source /opt/ros/humble/setup.bash # rviz2最后我个人最深刻的一个体会是处理自定义消息桥接时耐心和细致比技术本身更重要。确保两个版本的消息定义一字不差是成功的关键。一旦桥接成功建立看着旧系统中的数据在新框架下流畅地复现那种感觉就像让一台老式留声机在数字音响上播放出了黑胶唱片的声音既有传承的成就感也为新项目的开发铺平了道路。
1. 项目概述跨越ROS版本的数据回放挑战如果你是从ROS1“古早”版本一路摸爬滚打过来的机器人开发者手头肯定攒了一堆宝贵的.bag数据文件。这些bag包可能是当年调试SLAM算法时小车在实验室里磕磕绊绊跑了几十圈才录下来的点云和里程计也可能是某个已经退役的传感器留下的唯一一批校准数据。当团队决定将项目迁移到ROS2时一个非常现实且棘手的问题就摆在了面前这些记录了历史、承载了调试心血的ROS1 bag包难道就只能在ROS1环境下“养老”无法在新的ROS2生态中发挥余热了吗当然不是。rosbag_v2正是为解决这一痛点而生的工具。它不是一个独立的全新录包工具而是一个精巧的“转译器”和“播放器”。其核心使命是让你能够在纯ROS2的环境中直接读取、解析并回放ROS1格式的bag包将里面的话题数据原汁原味地或经过必要转换后发布到ROS2的DDS网络上。这意味着你那些用rosbag record录制的旧数据可以直接用来测试新的ROS2节点、验证算法移植后的正确性或者进行新旧系统的对比实验而无需折腾双系统、双ROS版本并行运行这种繁琐的操作。这个方法特别适合那些正在从ROS1向ROS2过渡的团队和个人。无论是评估迁移效果、复用历史数据训练模型还是单纯地不想丢掉过去的调试记录rosbag_v2都提供了一个相对平滑的桥梁。它省去了数据转换的中间步骤实现了“即开即用”式的回放对于提升开发调试效率有着实实在在的帮助。2. 核心原理与方案选型为什么是rosbag_v2在深入实操之前我们有必要拆解一下rosbag_v2的工作原理这能帮助我们在后面遇到问题时更快地定位根源。ROS1和ROS2在底层架构上存在代际差异最大的鸿沟在于中间件ROS1基于自定义的TCPROS/UDPROS而ROS2基于标准的DDS数据分发服务。这导致它们的话题消息、序列化方式乃至时间系统都不直接兼容。rosbag_v2方案的本质是在ROS2环境中创建一个“兼容层”。这个方案通常依赖于ros1_bridge这个关键组件。ros1_bridge是一个双向的、动态的桥接器它能在同一台机器的ROS1和ROS2网络之间自动转发话题和服务。而rosbag_v2回放ROS1 bag包的典型工作流如下启动ROS1核心虽然我们的目标是ROS2环境但为了解析ROS1的bag文件需要先启动一个ROS1的roscore。这个roscore运行在后台不干扰ROS2的DDS网络仅为bag文件解析提供必要的ROS1环境上下文。启动ros1_bridge接着启动ros1_bridge。它会监测指定的、或所有的话题。当有数据从ROS1侧发布时桥会自动将其转换为ROS2的消息类型并转发到ROS2网络反之亦然。使用rosbag play (ROS1版本)在已经拥有ROS1环境通过第一步的roscore的终端里使用传统的rosbag play命令播放你的ROS1 bag包。此时bag包中的数据会以ROS1话题的形式发布出来。桥接转发ros1_bridge捕获到这些ROS1话题的数据流实时地进行消息类型转换如果存在直接映射或通过自定义转换规则然后将转换后的数据以同名的或按规则重命名的ROS2话题发布出去。ROS2节点订阅你的ROS2应用程序无论是Rviz2、导航栈节点还是自定义算法节点此时就可以像订阅普通ROS2话题一样订阅这些由桥转发过来的数据从而实现回放。那么为什么不直接把bag包转换成ROS2格式呢确实存在离线转换工具如rosbag2的转换功能但对于复杂的、含有自定义消息类型的bag包离线转换可能需要编写大量的消息转换插件过程繁琐且容易出错。rosbag_v2这种“在线桥接播放”的方案优势在于动态性和灵活性。它利用了ros1_bridge的实时转换能力特别适合快速验证和调试。你不需要为所有消息类型预先写好转换器ros1_bridge对于ROS标准消息如sensor_msgs/Image,nav_msgs/Odometry等有内置支持对于自定义消息也提供了生成转换接口的方法。注意这种方法并非完美。它要求系统同时安装ROS1和ROS2并且需要同时运行两者的核心程序对系统资源有一定占用。此外实时桥接会引入微小的延迟对于极高频率或严格实时性要求的场景需要谨慎评估。但对于绝大多数调试、算法验证和数据复现场景其便利性远大于这些微小代价。3. 环境准备与安装部署工欲善其事必先利其器。要让rosbag_v2跑起来你的系统必须是一个同时包含ROS1和ROS2的“混合环境”。下面以Ubuntu 20.04 (ROS1 Noetic ROS2 Foxy) 和 Ubuntu 22.04 (ROS1 可安装Noetic ROS2 Humble) 为例给出详细的准备步骤。这里假设你已经有了一个ROS1的bag包。3.1 基础系统与ROS1环境确认首先确保你的ROS1环境是完好可用的。# 检查ROS1环境是否已配置 source /opt/ros/noetic/setup.bash # 根据你的ROS1版本调整如melodic, kinetic等 printenv | grep ROS你应该能看到ROS_VERSION1和ROS_DISTROnoetic等变量。尝试运行roscore确保能正常启动。这是后续所有步骤的基石。3.2 ROS2环境安装与配置如果你还没有安装ROS2需要先进行安装。以ROS2 Humble对应Ubuntu 22.04为例# 1. 设置语言环境 locale # 检查是否支持UTF-8 sudo apt update sudo apt install locales sudo locale-gen en_US en_US.UTF-8 sudo update-locale LC_ALLen_US.UTF-8 LANGen_US.UTF-8 export LANGen_US.UTF-8 # 2. 添加ROS2软件源 sudo apt install software-properties-common sudo add-apt-repository universe sudo apt update sudo apt install curl -y sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release echo $UBUNTU_CODENAME) main | sudo tee /etc/apt/sources.list.d/ros2.list /dev/null # 3. 安装ROS2桌面版推荐包含Rviz2、示例等 sudo apt update sudo apt install ros-humble-desktop # 4. 配置环境变量 source /opt/ros/humble/setup.bash echo “source /opt/ros/humble/setup.bash” ~/.bashrc # 可选添加到bashrc安装完成后新开一个终端测试ROS2基础功能source /opt/ros/humble/setup.bash ros2 run demo_nodes_cpp talker在另一个终端运行ros2 run demo_nodes_py listener应该能看到消息打印。3.3 关键组件ros1_bridge的编译安装ros1_bridge是连接两个世界的核心。虽然有些ROS2桌面版安装包可能包含了预编译的ros1_bridge但为了确保兼容性和功能完整特别是需要支持自定义消息时从源码编译是更可靠的做法。编译它需要一个同时能“看到”ROS1和ROS2的工作空间。# 1. 创建一个用于桥接的专属工作空间例如名为bridge_ws mkdir -p ~/bridge_ws/src cd ~/bridge_ws/src # 2. 克隆ros1_bridge源码 git clone https://github.com/ros2/ros1_bridge.git -b humble # 请将‘humble’替换为你的ROS2版本 # 3. 克隆示例代码包含测试消息定义可选但推荐 git clone https://github.com/ros2/example_interfaces.git git clone https://github.com/ros2/rcl_interfaces.git # 4. 配置工作空间关键步骤是同时source ROS1和ROS2的环境 cd ~/bridge_ws source /opt/ros/noetic/setup.bash # 先source ROS1 source /opt/ros/humble/setup.bash # 再source ROS2 # 5. 检查环境确保两个版本都存在 printenv | grep ROS_VERSION # 应该能看到ROS_VERSION1和ROS_VERSION2都被设置过当前生效的是2 # 6. 安装依赖并编译 sudo apt update sudo apt install python3-colcon-common-extensions -y colcon build --symlink-install --packages-select ros1_bridge --cmake-force-configure编译过程可能会花费一些时间因为它需要为所有已知的公共消息类型生成桥接代码。编译成功后你会在install目录下找到相关的库和可执行文件。实操心得编译ros1_bridge最常见的问题是环境变量冲突。务必遵循“先ROS1后ROS2”的source顺序。编译完成后使用这个工作空间时也需要按相同顺序sourcesource /opt/ros/noetic/setup.bash; source ~/bridge_ws/install/setup.bash注意此时通常不需要再显式source ROS2的setup.bash因为bridge工作空间的setup.bash会继承并覆盖所需环境。如果遇到关于消息类型的错误可能是你的ROS1或ROS2缺少某些消息包请根据错误提示使用apt或rosdep安装。4. 完整实操流程一步步回放你的ROS1 bag包假设我们有一个ROS1的bag包my_old_data.bag里面录制了/scan激光雷达和/odom里程计话题。我们的目标是在ROS2中回放它并用Rviz2进行可视化。4.1 第一步启动ROS1核心roscore打开第一个终端Terminal 1这个终端将专门负责ROS1侧的服务。# Terminal 1 source /opt/ros/noetic/setup.bash roscore保持这个终端运行你会看到熟悉的ROS1 master启动日志。4.2 第二步启动动态话题桥接器ros1_bridge打开第二个终端Terminal 2这里我们需要启动编译好的ros1_bridge。为了高效我们通常以“动态桥接”模式启动让它只转发我们感兴趣的话题而不是全部话题以减少开销。# Terminal 2 # 首先按顺序source环境 source /opt/ros/noetic/setup.bash source ~/bridge_ws/install/setup.bash # 这里包含了bridge和ROS2环境 # 启动动态桥接 ros2 run ros1_bridge dynamic_bridgedynamic_bridge启动后它会静静地等待监控ROS1和ROS2网络上的话题。当有话题在任意一侧出现时它会自动尝试为其创建桥接。4.3 第三步播放ROS1 bag包打开第三个终端Terminal 3在这里使用ROS1的工具播放bag包。关键点这个终端的环境变量必须只包含ROS1不能有ROS2否则rosbag命令可能会因为环境混合而出错。# Terminal 3 # 确保这是一个纯净的ROS1环境。如果之前source过ROS2请新开一个终端或重新登录。 source /opt/ros/noetic/setup.bash # 查看bag包信息 rosbag info my_old_data.bag # 开始播放bag包。使用--loop可以循环播放便于调试。 rosbag play my_old_data.bag --clock这里--clock参数非常重要它会发布/clock话题来模拟时间。ROS2的许多节点如TF2依赖于一个统一的时间源发布时钟可以确保时间系统的一致性。当rosbag play开始后你会在Terminal 3看到播放进度。同时在Terminal 2运行dynamic_bridge的终端中你应该能看到类似下面的日志输出Created 1to2 bridge for topic /scan with ROS2 type sensor_msgs/msg/LaserScan Created 1to2 bridge for topic /odom with ROS2 type nav_msgs/msg/Odometry Created 1to2 bridge for topic /clock with ROS2 type rosgraph_msgs/msg/Clock这表明桥接器已经成功检测到了ROS1的话题并为其创建了通往ROS2的桥梁。4.4 第四步在ROS2中验证与可视化现在打开第四个终端Terminal 4进入纯ROS2环境来验证数据是否成功过来了。# Terminal 4 source /opt/ros/humble/setup.bash # 或你的ROS2版本 # 查看当前ROS2网络中的话题列表 ros2 topic list你应该能在列表中看到/scan、/odom和/clock。这些话题现在已经是地道的ROS2话题了。# 查看某个话题的数据流确认数据正在发布 ros2 topic echo /odom --once | head -20 # 查看前20条消息概览最后启动Rviz2进行可视化# Terminal 4 (继续) rviz2在Rviz2中将Fixed Frame设置为你的机器人坐标系例如odom或base_link具体取决于bag包内容。点击Add添加一个LaserScan显示将Topic设置为/scan。再添加一个TF显示查看坐标系变换。 如果bag包里包含了TF数据并且播放时使用了--clock你应该能在Rviz2中看到激光扫描数据并且TF树也是正常的。至此你已经成功地在ROS2环境中回放了ROS1的bag包。5. 进阶技巧与自定义消息处理上面的流程适用于ROS标准消息。但实际项目中大量使用的是自定义消息。当bag包里包含自定义消息时dynamic_bridge无法自动识别和转换你会看到桥接日志报错“Could not determine the type for topic ...”。这时就需要我们手动为这些自定义消息生成桥接支持。5.1 为自定义消息创建桥接假设你在ROS1中有一个自定义消息包my_pkg其中定义了MyCustomMsg.msg。在ROS2中你有一个功能对等的包my_pkg_v2定义了相同的MyCustomMsg。核心思想你需要让ros1_bridge在编译时知道这一对消息类型的映射关系。准备消息包确保你的ROS1自定义消息包和ROS2自定义消息包都已在其各自的工作空间中成功编译。并且消息的定义必须完全一致字段名、字段类型、顺序。这是桥接能成功的前提。修改桥接工作空间的src进入之前编译ros1_bridge的~/bridge_ws/src目录。cd ~/bridge_ws/src克隆或链接你的自定义消息包你需要将ROS1和ROS2版本的自定义消息包源码都放到这个src目录下。可以通过git clone或创建软链接的方式。# 假设你的ROS1消息包路径是 ~/ros1_ws/src/my_pkg # 假设你的ROS2消息包路径是 ~/ros2_ws/src/my_pkg_v2 ln -s ~/ros1_ws/src/my_pkg . ln -s ~/ros2_ws/src/my_pkg_v2 .重新编译ros1_bridge在编译时ros1_bridge的CMake脚本会自动扫描src目录下所有的ROS1和ROS2包并为找到的同名且同结构的消息生成桥接代码。cd ~/bridge_ws # 再次按顺序source环境 source /opt/ros/noetic/setup.bash source /opt/ros/humble/setup.bash # 清理旧编译结果可选但推荐 rm -rf build/ install/ log/ # 重新编译这次会包含你的自定义包 colcon build --symlink-install --packages-select ros1_bridge --cmake-force-configure验证编译成功后重新运行dynamic_bridge并播放包含自定义消息的bag包。此时桥接器应该能成功创建转换桥例如Created 1to2 bridge for topic /custom_data with ROS2 type my_pkg_v2/msg/MyCustomMsg5.2 性能优化与参数调整回放大型bag包或高频数据时可能会遇到性能瓶颈或数据丢失。可以尝试以下调整限制桥接话题如果bag包话题很多但只关心其中几个可以在启动dynamic_bridge时指定话题白名单避免不必要的转换开销。ros2 run ros1_bridge dynamic_bridge --bridge-all-topics false --topic /scan --topic /odom调整rosbag play参数-r 2以2倍速播放加快测试。-d 5在开始播放前延迟5秒给桥接器和订阅者足够的启动时间。--pause启动时暂停方便你手动在Rviz2中做好所有配置后再按空格键开始播放。使用静态桥接对于已知的、固定的消息类型集合可以编译一个静态桥接器性能比动态桥接更好。这需要在ros1_bridge包的CMakeLists.txt中配置要桥接的具体消息类型对然后编译出一个专用的静态桥接节点。这更复杂适合消息类型稳定后的生产环境。6. 常见问题排查与实战避坑指南在实际操作中你几乎一定会遇到一些问题。下面是我踩过坑后总结的常见问题及解决方法。6.1 桥接器没有创建话题桥现象rosbag play启动了但dynamic_bridge终端没有任何“Created ... bridge”的日志ROS2的ros2 topic list里也看不到话题。排查环境隔离确保播放bag包的终端Terminal 3是纯ROS1环境。用echo $ROS_VERSION检查必须为1。如果混入了ROS2环境rosbag play可能无法正确与ROS1的roscore通信。网络配置检查ROS_MASTER_URI。在Terminal 1 (roscore终端) 和 Terminal 3 (rosbag play终端)echo $ROS_MASTER_URI应该指向同一个地址通常是http://localhost:11311。ROS2侧不关心这个变量。桥接器状态在dynamic_bridge终端按几次回车看是否有反应。有时日志被缓冲了。也可以尝试增加日志级别ros2 run ros1_bridge dynamic_bridge --ros-args --log-level debug。6.2 消息类型不匹配错误现象桥接器日志显示“Could not determine the type for topic X”或“No template specialization for ...”。排查标准消息即使是标准消息也可能因为ROS1和ROS2的包命名细微差别而出错。确保你的ROS2环境安装了对应的消息包如ros-humble-sensor-msgs。自定义消息这是最常见的原因。严格按照5.1节的步骤操作。最关键的是消息定义必须完全一致。使用rosmsg show(ROS1) 和ros2 interface show(ROS2) 仔细对比两个消息的定义一个标点符号都不能差。编译清理在重新添加自定义消息包后务必彻底清理bridge_ws下的build,install,log目录再重新编译避免旧缓存干扰。6.3 Rviz2中看不到数据/TF树错误现象话题列表里有数据但Rviz2中激光扫描不显示或者TF显示No transform available。排查时钟这是最可能的原因务必在rosbag play时加上--clock参数。ROS2的TF2强烈依赖一个统一的时间源。没有时钟许多基于时间的插件无法工作。Fixed Frame检查Rviz2左上角的Fixed Frame设置是否正确。它应该设置为bag包中TF树的根坐标系通常是odom或map。你可以通过ros2 topic echo /tf_static或ros2 run tf2_ros tf2_monitor来查看可用的TF帧。数据频率有些显示插件如LaserScan有“Deadline”设置。如果bag包数据频率很低可以尝试在Rviz2的显示属性中将Decay Time调大。6.4 性能问题与数据丢失现象回放时CPU占用率高或者ROS2端接收到的消息序列不连续有丢失。优化桥接模式从动态桥切换为静态桥接能显著提升性能。播放速率尝试用-r 0.5半速播放给系统更长的处理时间。话题过滤如果bag包里有你不需要的高频话题如图像可以在rosbag play时使用--topics参数只播放需要的几个话题或者用rosbag filter事先处理bag包。系统资源关闭不必要的图形界面和其他占用资源的程序。桥接和消息转换是CPU密集型操作。6.5 一个终端命令清单为了方便操作你可以将以下命令保存为脚本。但请注意由于环境变量管理复杂更推荐按步骤在不同终端手动执行。#!/bin/bash # 这是一个概念性脚本演示流程。实际使用请分终端执行。 # 终端1: ROS1 Core # source /opt/ros/noetic/setup.bash # roscore # 终端2: 动态桥接 (需要先source ROS1再source bridge_ws) # source /opt/ros/noetic/setup.bash # source ~/bridge_ws/install/setup.bash # ros2 run ros1_bridge dynamic_bridge # 终端3: 播放ROS1 bag (纯净ROS1环境) # source /opt/ros/noetic/setup.bash # rosbag play my_old_data.bag --clock --loop # 终端4: ROS2可视化 # source /opt/ros/humble/setup.bash # rviz2最后我个人最深刻的一个体会是处理自定义消息桥接时耐心和细致比技术本身更重要。确保两个版本的消息定义一字不差是成功的关键。一旦桥接成功建立看着旧系统中的数据在新框架下流畅地复现那种感觉就像让一台老式留声机在数字音响上播放出了黑胶唱片的声音既有传承的成就感也为新项目的开发铺平了道路。
