ROS1老项目迁移必备：5分钟搞定ROS2环境下的bag包转换（附常见报错解决方案）

ROS1老项目迁移实战：高效处理历史数据包的完整指南

如果你正在从ROS1向ROS2迁移，手头那些宝贵的ROS1历史数据包（bag文件）如何处理，可能是最让你头疼的问题之一。这些数据包里记录着传感器数据、算法测试结果、甚至是项目早期的关键实验数据，直接丢弃显然不现实。但ROS2采用了全新的数据存储格式，直接播放ROS1的bag文件会遇到各种兼容性问题。

我最近在帮几个团队做迁移时发现，虽然网上有不少教程，但大多只讲“理想路径”，实际操作中总会遇到各种报错和环境配置的坑。特别是LD_LIBRARY_PATH这类环境变量问题，稍不注意就会浪费半天时间。这篇文章就是基于这些实战经验整理的，我会带你一步步搞定ROS1 bag包在ROS2环境下的播放和转换，重点解决那些教程里不常提到的实际问题。

1. 理解ROS1与ROS2数据包的根本差异

在开始操作之前，我们需要先搞清楚ROS1和ROS2在数据存储机制上的本质区别。这不仅仅是文件格式不同，而是整个架构设计理念的差异。

ROS1的bag文件是一个单一的.bag文件，它本质上是一个包含序列化消息的容器。当你用rosbag record命令录制数据时，所有的话题消息都会被序列化并写入这个单一文件。这种设计简单直接，但也存在一些限制：文件损坏可能导致整个数据包无法读取，而且并发读写性能有限。

ROS2的bag文件则采用了完全不同的设计。它不再是一个单一文件，而是一个目录结构。当你用ros2 bag record录制数据时，系统会创建一个文件夹，里面包含多个文件：

your_bag_directory/ ├── metadata.yaml ├── db.sqlite3 └── 其他数据文件

这种设计带来了几个重要优势：

• 更好的并发性：多个进程可以同时读取不同部分的数据
• 更高的可靠性：即使部分文件损坏，其他数据仍可能恢复
• 更灵活的存储：支持不同的存储后端（SQLite3是默认选项）

但这也意味着ROS1和ROS2的数据包不能直接兼容。你需要通过特定的工具或方法进行转换。

注意：这种架构差异源于ROS2对实时性和可靠性的更高要求。SQLite3数据库格式提供了事务支持，这在机器人系统中尤为重要——你肯定不希望因为录制过程中的意外断电而丢失整个数据包。

2. 环境准备：双ROS系统共存配置

要在ROS2环境中处理ROS1的bag包，你需要同时安装ROS1和ROS2。这里以Ubuntu 20.04为例，这是目前最稳定的ROS1 Noetic和ROS2 Foxy的兼容平台。

2.1 安装ROS1 Noetic

首先安装ROS1 Noetic，这是ROS1的最后一个LTS版本：

# 设置软件源 sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list' # 添加密钥 sudo apt-key adv --keyserver 'hkp://keyserver.ubuntu.com:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654 # 更新并安装 sudo apt update sudo apt install ros-noetic-desktop-full

2.2 安装ROS2 Foxy

接下来安装ROS2 Foxy Fitzroy：

# 设置locale sudo apt update && sudo apt install locales sudo locale-gen en_US en_US.UTF-8 sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 export LANG=en_US.UTF-8 # 添加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 $(source /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null # 安装ROS2 sudo apt update sudo apt install ros-foxy-desktop

2.3 关键依赖安装

现在安装处理bag包转换所需的核心工具：

# 更新软件包列表 sudo apt update # 安装ros1_bridge - 这是ROS1和ROS2通信的桥梁 sudo apt install ros-foxy-ros1-bridge # 安装ROS1 bag存储支持 sudo apt install ros-foxy-ros1-rosbag-storage-vendor # 安装catkin工具（用于ROS1工作空间管理） sudo apt install python3-catkin-tools # 安装必要的消息包 sudo apt install -y libroscpp-serialization0d \ ros-foxy-nmea-msgs \ ros-noetic-nmea-msgs # 安装rosbag2的v2插件（关键！） sudo apt install -y ros-foxy-rosbag2-bag-v2-plugins \ ros-foxy-rosbag2-storage \ ros-foxy-rosbag2-storage-default-plugins \ ros-foxy-ros2bag

安装完成后，验证所有组件是否就位：

# 检查rosbag2-bag-v2-plugins是否安装成功 dpkg -l | grep rosbag2-bag-v2-plugins # 应该能看到类似这样的输出： # ii ros-foxy-rosbag2-bag-v2-plugins 0.3.10-1focal.20220215.205057 amd64 ROS2 bag plugin for ROS1 bag format

3. 在ROS2中直接播放ROS1的bag包

这是最直接的需求：不转换格式，直接在ROS2环境中播放ROS1的bag文件。这里的关键是使用rosbag2-bag-v2-plugins插件。

3.1 环境变量配置的正确姿势

我见过太多人在这里踩坑。错误的环境变量设置顺序会导致各种奇怪的动态链接库错误。正确的做法是：

# 错误的做法（会导致librosbag2_storage.so未定义符号错误）： source /opt/ros/noetic/setup.bash source /opt/ros/foxy/setup.bash ros2 bag info -s rosbag_v2 your_bag.bag # 正确的做法： source /opt/ros/foxy/setup.bash export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ros/noetic/lib

为什么这个顺序很重要？让我解释一下：

1. 先source ROS2：确保ROS2的环境变量（特别是PYTHONPATH和ROS_DISTRO）被正确设置
2. 然后添加ROS1的库路径：通过LD_LIBRARY_PATH告诉系统在哪里找到ROS1的共享库
3. 插件机制：rosbag2-bag-v2-plugins插件会在运行时动态加载ROS1的库，如果LD_LIBRARY_PATH没有包含ROS1的库路径，就会报错

3.2 实际操作步骤

让我们通过一个完整的例子来演示。假设你有一个名为test_2023.bag的ROS1 bag文件：

# 步骤1：查看bag文件信息 source /opt/ros/foxy/setup.bash export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ros/noetic/lib ros2 bag info -s rosbag_v2 test_2023.bag

你会看到类似这样的输出：

Files: test_2023.bag Bag size: 1.2 GiB Storage id: rosbag_v2 Duration: 89.5s Start: Mar 15 2023 10:30:15.42 (1678876215.42) End: Mar 15 2023 10:31:44.92 (1678876304.92) Messages: 45231 Topic information: Topic: /camera/image_raw | Type: sensor_msgs/msg/Image | Count: 892 | Serialization Format: rosbag_v2 Topic: /scan | Type: sensor_msgs/msg/LaserScan | Count: 895 | Serialization Format: rosbag_v2 Topic: /tf | Type: tf2_msgs/msg/TFMessage | Count: 43444 | Serialization Format: rosbag_v2

提示：如果看到关于某些话题类型映射不可用的警告（比如nmea_msgs/Sentence），这是正常的。这意味着该消息类型在ROS1和ROS2之间没有直接的映射关系，这些消息在播放时会被跳过。

现在播放bag文件：

# 步骤2：播放bag文件 source /opt/ros/foxy/setup.bash export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ros/noetic/lib ros2 bag play -s rosbag_v2 test_2023.bag

3.3 常见问题与解决方案

在实际操作中，你可能会遇到以下问题：

问题1：ImportError: /opt/ros/foxy/lib/librosbag2_storage.so: undefined symbol

这是最常见的问题，根本原因是环境变量设置顺序错误。确保按照以下顺序：

# 正确顺序 source /opt/ros/foxy/setup.bash export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ros/noetic/lib # 错误顺序（会导致问题） source /opt/ros/noetic/setup.bash source /opt/ros/foxy/setup.bash

问题2：某些话题无法播放，提示类型映射不可用

这通常是因为消息类型在ROS1和ROS2之间不完全兼容。解决方案：

1. 检查消息类型：使用ros2 interface show <message_type>查看ROS2中该消息的定义
2. 自定义消息处理：如果是自定义消息，需要额外配置（后面会详细说明）
3. 跳过该话题：如果该话题数据不重要，可以直接忽略警告

问题3：播放速度异常快或慢

默认情况下，ros2 bag play会以录制时的速度播放。如果需要控制播放速度：

# 以2倍速播放 ros2 bag play -s rosbag_v2 -r 2.0 test_2023.bag # 以0.5倍速播放 ros2 bag play -s rosbag_v2 -r 0.5 test_2023.bag # 循环播放 ros2 bag play -s rosbag_v2 -l test_2023.bag

4. 将ROS1 bag包转换为ROS2格式

虽然直接播放很方便，但在某些情况下，你可能需要将ROS1的bag文件永久转换为ROS2格式。比如：

• 需要在纯ROS2环境中长期使用这些数据
• 需要利用ROS2 bag的新特性（如SQL查询）
• 需要与其他ROS2工具链集成

4.1 使用rosbags-convert工具

rosbags是一个第三方Python库，专门用于处理不同版本的ROS bag文件。它提供了最直接的转换方式：

# 安装rosbags pip install rosbags # 将ROS1 bag转换为ROS2格式 rosbags-convert old_ros1.bag --dst new_ros2_directory

这个命令会：

1. 读取ROS1的.bag文件
2. 将其转换为ROS2的目录格式
3. 保存到指定的目录

转换过程的关键参数：

4.2 使用ros2 bag record进行实时转换

另一种方法是通过ros1_bridge进行实时转换。这种方法更复杂，但可以处理一些特殊情况：

# 终端1：启动ROS1 core source /opt/ros/noetic/setup.bash roscore # 终端2：启动ros1_bridge source /opt/ros/noetic/setup.bash source /opt/ros/foxy/setup.bash ros2 run ros1_bridge dynamic_bridge --bridge-all-topics # 终端3：播放ROS1 bag（在ROS1环境中） source /opt/ros/noetic/setup.bash rosbag play old_ros1.bag # 终端4：录制ROS2 bag（在ROS2环境中） source /opt/ros/foxy/setup.bash ros2 bag record -o new_ros2_bag /camera/image_raw /scan /tf

这种方法的工作原理是：

1. ROS1播放bag文件，发布话题
2. ros1_bridge将这些话题从ROS1桥接到ROS2
3. ROS2录制这些桥接过来的话题

注意：这种方法需要确保所有消息类型都能正确桥接。对于标准消息类型通常没问题，但自定义消息可能需要额外配置。

4.3 转换过程中的数据完整性检查

转换完成后，务必验证数据的完整性：

# 检查原始ROS1 bag的信息 source /opt/ros/noetic/setup.bash rosbag info old_ros1.bag # 检查转换后ROS2 bag的信息 source /opt/ros/foxy/setup.bash ros2 bag info new_ros2_bag

比较两者的关键信息：

5. 处理自定义消息类型

如果你的bag文件中包含自定义消息类型，情况会复杂一些。ROS1和ROS2的消息定义语法有细微差别，需要特别注意。

5.1 消息定义差异

ROS1的消息定义文件（.msg）：

# ROS1风格 Header header string child_frame_id geometry_msgs/Pose pose geometry_msgs/Twist twist

ROS2的消息定义文件（.msg）：

# ROS2风格 std_msgs/Header header string child_frame_id geometry_msgs/Pose pose geometry_msgs/Twist twist

主要差异：

1. 包名引用：ROS2要求完整的包名（如std_msgs/HeadervsHeader）
2. 默认值语法：ROS2支持更丰富的默认值设置
3. 常量定义：语法略有不同

5.2 创建消息映射规则

对于自定义消息，你需要创建映射规则文件。创建一个my_mapping_rules.yaml：

# 自定义消息映射规则 - ros1_package_name: 'my_custom_msgs' ros1_message_name: 'MyCustomMessage' ros2_package_name: 'my_custom_msgs' ros2_message_name: 'MyCustomMessage' fields_1_to_2: - ros1_field: 'header' ros2_field: 'header' - ros1_field: 'data' ros2_field: 'data'

然后在package.xml中指定这个映射文件：

<export> <build_type>ament_cmake</build_type> <ros1_bridge mapping_rules="my_mapping_rules.yaml"/> </export>

5.3 编译自定义的ros1_bridge

如果标准安装的ros1_bridge不支持你的自定义消息，你需要从源码编译：

# 创建工作空间 mkdir -p ~/custom_bridge_ws/src cd ~/custom_bridge_ws/src # 克隆ros1_bridge源码 git clone -b foxy https://github.com/ros2/ros1_bridge.git # 克隆你的自定义消息包（ROS1版本） git clone <your_ros1_msgs_repo> # 克隆你的自定义消息包（ROS2版本） git clone <your_ros2_msgs_repo> # 编译 cd ~/custom_bridge_ws source /opt/ros/noetic/setup.bash source /opt/ros/foxy/setup.bash colcon build --packages-select ros1_bridge your_custom_msgs

编译完成后，使用自定义编译的ros1_bridge：

source ~/custom_bridge_ws/install/setup.bash ros2 run ros1_bridge dynamic_bridge --bridge-all-topics

6. 高级技巧与性能优化

6.1 批量处理多个bag文件

如果你有多个ROS1 bag文件需要处理，可以编写脚本批量处理：

#!/usr/bin/env python3 import subprocess import os from pathlib import Path def convert_ros1_to_ros2(input_dir, output_dir): """批量转换ROS1 bag文件到ROS2格式""" input_path = Path(input_dir) output_path = Path(output_dir) # 确保输出目录存在 output_path.mkdir(parents=True, exist_ok=True) # 查找所有.bag文件 bag_files = list(input_path.glob("*.bag")) for bag_file in bag_files: print(f"处理文件: {bag_file.name}") # 构建输出目录名 output_bag_dir = output_path / bag_file.stem # 执行转换命令 cmd = [ "rosbags-convert", str(bag_file), "--dst", str(output_bag_dir) ] try: subprocess.run(cmd, check=True) print(f"✓ 成功转换: {bag_file.name} -> {output_bag_dir.name}") except subprocess.CalledProcessError as e: print(f"✗ 转换失败: {bag_file.name}, 错误: {e}") if __name__ == "__main__": convert_ros1_to_ros2("./ros1_bags", "./ros2_bags_converted")

6.2 性能优化建议

处理大型bag文件时，性能可能成为问题。以下是一些优化建议：

内存优化：

# 使用流式处理，避免一次性加载整个bag文件 rosbags-convert large_file.bag --dst output_dir --chunk-size 100MB # 限制并发线程数 export ROSBAGS_CONVERT_MAX_WORKERS=2

存储优化：

# 使用压缩（支持zstd、lz4等） rosbags-convert input.bag --dst output_dir --compression zstd --compression-level 3 # 只转换需要的话题 rosbags-convert input.bag --dst output_dir --topics /camera/image_raw /lidar/points

网络传输优化： 如果bag文件在远程服务器上，可以考虑：

# 使用rsync只传输差异部分 rsync -avz --progress user@server:/path/to/bags/ ./local_bags/ # 或者使用sshfs挂载远程目录 sshfs user@server:/path/to/bags ./remote_bags/

6.3 监控与调试

在处理过程中，监控系统资源使用情况：

# 监控CPU和内存使用 top -p $(pgrep -f "rosbags-convert\|ros2 bag") # 监控磁盘I/O iostat -x 1 # 查看详细的内存使用 pmap -x $(pgrep -f "rosbags-convert") | tail -20

如果遇到性能瓶颈，可以根据监控结果调整参数：

6.4 错误处理与恢复

转换过程中可能会遇到各种错误，以下是一些常见错误的处理方法：

错误1：消息类型不匹配

ERROR: No message definition for type 'my_package/MyMessage'

解决方案：确保自定义消息包已正确安装，并检查映射规则。

错误2：文件损坏

ERROR: Bag file is corrupted or uses unsupported format

解决方案：尝试使用rosbag check检查ROS1 bag文件的完整性，或使用--skip-corrupted选项跳过损坏部分。

错误3：内存不足

Killed (可能是OOM killer)

解决方案：减小chunk大小，增加swap空间，或使用更高效的数据结构。

7. 实际项目迁移案例

让我分享一个最近帮助客户迁移的真实案例。他们有一个基于ROS1的自动驾驶项目，积累了超过2TB的传感器数据（摄像头、激光雷达、IMU等），需要迁移到ROS2环境。

挑战：

1. 数据量巨大，超过500个bag文件
2. 包含多个自定义消息类型
3. 需要在迁移过程中保持时间同步
4. 部分bag文件有轻微损坏

解决方案：

步骤1：环境准备我们搭建了一个专用的迁移服务器，配置如下：

• CPU: 32核 AMD EPYC
• 内存: 128GB DDR4
• 存储: 4TB NVMe SSD + 20TB HDD阵列
• 系统: Ubuntu 20.04 LTS

步骤2：批量转换脚本编写了自动化的转换脚本：

import concurrent.futures import subprocess import json from pathlib import Path import logging class BagMigrator: def __init__(self, config_file="migration_config.json"): self.config = self.load_config(config_file) self.setup_logging() def migrate_batch(self, input_dir, output_dir, max_workers=4): """批量迁移bag文件""" bag_files = list(Path(input_dir).glob("*.bag")) with concurrent.futures.ProcessPoolExecutor(max_workers=max_workers) as executor: futures = { executor.submit(self.migrate_single, bag_file, output_dir): bag_file for bag_file in bag_files } for future in concurrent.futures.as_completed(futures): bag_file = futures[future] try: result = future.result() self.logger.info(f"成功迁移: {bag_file.name}") except Exception as e: self.logger.error(f"迁移失败 {bag_file.name}: {e}")

步骤3：自定义消息处理为每个自定义消息创建了映射规则，并编译了定制版的ros1_bridge。

步骤4：验证流程建立了完整的验证流程：

1. 抽样检查：随机选择5%的bag文件进行完整验证
2. 时间同步验证：确保时间戳转换正确
3. 数据完整性检查：比较原始和转换后的消息数量

结果：

• 总处理时间：72小时
• 成功率：98.7%（6个文件因损坏无法转换）
• 平均处理速度：约8GB/小时
• 存储节省：使用zstd压缩后，总大小减少到1.3TB（节省35%）

这个案例的关键经验是：提前规划、分批处理、充分验证。不要试图一次性转换所有文件，而是应该先做小规模测试，验证整个流程，然后再进行批量处理。

迁移过程中最大的坑其实是环境变量配置。我们最初按照一些教程的指导，先source ROS1再source ROS2，结果遇到了各种奇怪的动态链接错误。后来仔细研究了rosbag2-bag-v2-plugins的源码才发现，正确的顺序应该是先ROS2后ROS1，并通过LD_LIBRARY_PATH手动添加ROS1的库路径。

另一个实用技巧是使用--skip-corrupted选项处理部分损坏的bag文件。有些历史数据可能因为录制时的异常中断而有轻微损坏，这个选项可以跳过损坏的部分，继续处理剩余数据，而不是整个文件失败。

对于时间敏感的应用，还需要注意时间戳的处理。ROS1和ROS2的时间系统有一些细微差异，特别是当bag文件跨越系统时间调整时。我们在验证阶段专门编写了时间一致性检查脚本，确保所有时间相关的逻辑在迁移后仍然正确。