RealSense ROS 2 图像显示问题排查指南

问题背景

在使用 Intel RealSense D415 深度相机配合 ROS 2 进行开发时，用户遇到了图像数据无法正常显示的问题。虽然相机在 RealSense Viewer 中工作正常，但在 ROS 2 环境中无法通过标准工具查看图像数据。

环境配置

• 硬件设备: Intel RealSense D415 深度相机
• 固件版本: 5.15.1
• 操作系统: Linux (内核版本 6.5.0)
• ROS 发行版: Humble
• RealSense SDK 版本: 2.54.1
• RealSense ROS Wrapper 版本: 4.54.1

问题现象

用户通过以下命令启动 RealSense 相机节点：

ros2 launch realsense2_camera rs_launch.py clip_distance:=1.0 spatial_filter.enable:=true temporal_filter.enable:=true decimation_filter.enable:=true enable_color:=true rgb_camera.profile:=1280x720x30 initial_reset:=true enable_depth:=true

节点日志显示启动成功，但尝试通过以下方式查看图像时出现问题：

1. 使用 ros2 run image_tools showimage 查看图像时无显示
2. 使用 ros2 topic echo 查看话题时无输出

排查过程

1. 版本兼容性检查

首先确认了 RealSense SDK 和 ROS Wrapper 的版本兼容性。正确的版本组合应为：

• RealSense SDK 2.54.1
• ROS Wrapper 4.54.1

2. SDK 版本管理

当需要安装特定版本的 RealSense SDK 时，可以使用以下命令查询可用版本：

apt-cache showpkg librealsense2

然后安装指定版本的核心组件：

sudo apt-get install librealsense2-utils=2.54.1-0~realsense.9591 librealsense2=2.54.1-0~realsense.9591 librealsense2-gl=2.54.1-0~realsense.9591

3. ROS Wrapper 构建问题

在构建 ROS Wrapper 时，可能会遇到以下问题：

问题1: rosdep 源列表文件已存在

ERROR: default sources list file already exists:
/etc/ros/rosdep/sources.list.d/20-default.list

解决方案:

sudo rm /etc/ros/rosdep/sources.list.d/20-default.list
sudo rosdep init

问题2: 构建时报告 RealSense SDK 缺失

解决方案: 设置正确的环境变量路径

export COLCON_PREFIX_PATH=/home/<username>/ros2_ws/install:$COLCON_PREFIX_PATH
export CMAKE_PREFIX_PATH=/home/<username>/vcpkg/installed/x64-linux/share/realsense2:$CMAKE_PREFIX_PATH

4. 数据验证方法

确认数据是否正常发布的几种方法：

1. RViz 可视化: 最直观的验证方式，可以确认图像数据是否正确传输

2. 话题回显:

   ros2 topic echo /camera/color/image_raw
   

3. 图像查看工具:

   ros2 run image_tools showimage image:=/camera/color/image_raw
   

根本原因

最终发现问题的根源是订阅了错误的话题路径。正确的话题路径应为：

/camera/camera/depth/image_rect_raw

而错误订阅的路径为：

/camera/depth/image_rect_raw

经验总结

1. 版本管理至关重要：确保 RealSense SDK 和 ROS Wrapper 版本严格匹配

2. 构建环境清理：在版本变更后，彻底清理构建环境并重新构建

3. 验证流程：建立系统化的数据验证流程，从底层话题到上层应用逐步确认

4. 路径准确性：特别注意 ROS 话题路径的准确性，微小的差异可能导致完全不同的结果

5. 日志分析：养成查看节点启动日志和运行时日志的习惯，很多问题都能从中发现线索

通过系统化的排查和验证，可以有效解决 RealSense 在 ROS 2 环境中的图像显示问题，确保深度视觉应用的顺利开发。