ROS2 Foxy到Humble：rosbag2录制与播放的完整配置流程（含常见错误排查）

在机器人开发领域，数据记录与回放一直是调试和验证的关键环节。ROS2作为新一代机器人操作系统，其数据记录工具rosbag2在架构和功能上都进行了全面升级。本文将带您深入探索从Foxy到Humble版本中rosbag2的核心使用方法，解决实际开发中可能遇到的各种挑战。

1. ROS2 rosbag2环境配置与基础概念

rosbag2是ROS2中用于记录和回放话题数据的核心工具，相比ROS1的rosbag，它采用了全新的存储格式和API设计。在开始使用前，我们需要确保环境正确配置。

安装rosbag2及相关组件（以Ubuntu 22.04 + Humble为例）：

sudo apt install ros-humble-rosbag2 ros-humble-rosbag2-storage-default-plugins ros-humble-rosbag2-converter-default-plugins

rosbag2默认使用SQLite3作为存储后端（文件扩展名为.db3），这种设计带来了几个显著优势：

• 更高效的数据索引和查询能力
• 支持并行读写操作
• 内置数据完整性校验机制

关键组件对比：

提示：从Galactic版本开始，rosbag2增加了对MCAP格式的支持，可通过安装ros-humble-rosbag2-storage-mcap插件启用。

2. rosbag2录制实战：从基础到高级

2.1 基础录制命令

最简单的录制方式是记录所有活跃话题：

ros2 bag record -a

这将在当前目录创建一个以时间戳命名的文件夹，内含metadata.yaml和实际的.db3数据文件。但实际开发中，我们通常需要更精确的控制：

录制特定话题：

ros2 bag record /scan /odom /tf

指定存储位置和文件名：

ros2 bag record -o custom_name /scan /odom

2.2 高级录制选项

rosbag2提供了丰富的参数来满足不同场景需求：

• 自定义存储格式：

  ros2 bag record --storage mcap -a

• 设置录制时长（单位秒）：

  ros2 bag record --duration 30 /scan

• 分割大文件（按大小或时长）：

  ros2 bag record --max-bag-size 100 -a # 100MB分割

• 录制服务质量(QoS)配置：

  ros2 bag record --qos-profile-overrides-path qos_overrides.yaml /scan

注意：Humble版本开始支持--compression-mode和--compression-format参数，可选择zstd或lz4压缩算法减少存储空间占用。

3. rosbag2播放与数据处理技巧

3.1 基础播放操作

播放录制的bag文件非常简单：

ros2 bag play recorded_bag

但实际应用中，我们经常需要更精细的控制：

常用播放参数：

• --rate：控制播放速度（1.0为实时）
• --loop：循环播放
• --remap：重映射话题名称
• --topics：仅播放指定话题

示例：

ros2 bag play recorded_bag --rate 0.5 --loop --remap /scan:=/new_scan

3.2 时间控制与同步

rosbag2提供了精确的时间控制能力：

从特定时间点开始播放（单位秒）：

ros2 bag play recorded_bag --start-offset 5

仅播放特定时间段：

ros2 bag play recorded_bag --start-offset 5 --duration 10

同步到系统时钟：

ros2 bag play recorded_bag --clock

重要：使用--clock选项时，需要确保use_sim_time参数已设置为true：

ros2 param set /use_sim_time true

4. 常见问题排查与性能优化

4.1 典型错误解决方案

问题1：播放时无数据输出

• 检查话题名称是否匹配：ros2 topic list
• 确认消息类型是否兼容：ros2 topic info /topic_name

问题2：录制文件损坏

ros2 bag reindex corrupted_bag

问题3：存储空间不足

• 使用压缩选项：--compression-mode file --compression-format zstd
• 定期分割文件：--max-bag-size或--max-bag-duration

4.2 性能优化建议

录制优化：

• 避免录制高频率图像话题
• 使用--storage mcap格式处理大流量数据
• 关闭不需要的插件减少资源占用

播放优化：

ros2 bag play --read-ahead-queue-size 100 recorded_bag

存储优化配置：

# rosbag2_storage.yaml max_cache_size: 100MB max_bagfile_size: 1GB storage_preset_profile: "resilient"

5. ROS1与ROS2 bag转换实战

虽然rosbag2采用了全新架构，但ROS1的bag文件仍可通过转换工具继续使用：

安装转换工具：

sudo apt install ros-humble-ros1-bridge ros-humble-rosbag2-bag-v2

转换步骤：

1. 启动ROS1环境：

   source /opt/ros/noetic/setup.bash

2. 执行转换：

   ros2 run rosbag2_bag_v2 converter <input.bag> -o <output_dir>

转换注意事项：

• 消息类型需在两个版本中都存在
• 复杂消息可能需要手动映射
• 时间戳信息会完整保留

在实际项目中，我发现转换后的bag文件播放时偶尔会出现时间同步问题。一个实用的解决方法是使用--start-offset参数稍微延迟播放开始时间，让系统有足够时间初始化所有组件。