机器人 / 系统课时

在订阅回调中处理消息

在订阅回调中处理消息

订阅者已创建却没有输出时,需要分清消息是否到达,以及回调是否真正执行。这里使用一个独立的 rclpy 进程订阅 /chatter,读取 String.data 并累计有效消息,再通过另一进程发布正常与空字符串,验证回调触发及排查方法。

学习目标

  • 使用 create_subscription() 注册回调并读取 String.data。
  • 理解 rclpy.spin()、话题匹配与回调调度的关系。
  • 在两个进程间验证消息收发,并区分回调触发与业务过滤。

回调在什么条件下执行

订阅者需要匹配发布者的话题名 /chatter、消息类型 std_msgs/msg/String 和兼容的 QoS 策略,双方还应处于同一 ROS 通信域。消息到达后,由 rclpy.spin(node) 驱动执行器调度回调;仅创建订阅对象,并不会自动运行回调。

create_subscription() 的最后一个参数设为 10,表示保留最近 10 条消息的历史深度,不是每秒执行 10 次。默认易失性(Volatile)不会补发订阅者出现之前的旧消息,因此一次性测试要先启动订阅者。

发布消息、DDS 传递与 Python 回调调度的时序关系

编写读取消息的订阅者

适用环境为 Ubuntu 24.04 与 ROS 2 Jazzy,已安装 rclpy、std_msgs。将以下完整程序保存为工作目录中的 subscriber.py。回调的 msg 是 String 对象,实际文本在 msg.data 中;这里把空消息视为无效业务数据,但仍明确记录其到达。

python
import rclpy
from rclpy.node import Node
from std_msgs.msg import String

class ChatterListener(Node):
    def __init__(self):
        super().__init__('chatter_listener')
        self.handled = 0
        # 绑定消息类型、话题、回调及 QoS 历史深度
        self.subscription = self.create_subscription(
            String, '/chatter', self.on_message, 10
        )

    def on_message(self, msg: String) -> None:
        # 空消息同样触发回调,但不计入有效消息
        if not msg.data.strip():
            self.get_logger().warning('收到空字符串,跳过处理')
            return

        self.handled += 1
        self.get_logger().info(f'第{self.handled}条消息:{msg.data}')

def main(args=None):
    rclpy.init(args=args)
    node = ChatterListener()
    try:
        # 持续分派就绪的回调,直到进程退出
        rclpy.spin(node)
    except KeyboardInterrupt:
        pass
    finally:
        node.destroy_node()
        rclpy.shutdown()

if __name__ == '__main__':
    main()

预期结果:脚本不会自行发布消息,只有订阅到数据后才记录日志。非空字符串使 handled 加 1,空字符串只产生警告;回调中不应加入长时间睡眠或阻塞式网络请求,以免拖延后续处理。

用两个终端验证通信

两个终端都加载 Jazzy 环境,并设置相同的 ROS_DOMAIN_ID=21。直接运行这个单文件示例,无需先创建功能包或执行 colcon build。

在终端 A 的脚本所在目录执行:

bash
source /opt/ros/jazzy/setup.bash
export ROS_DOMAIN_ID=21
python3 subscriber.py

预期结果:进程保持运行,尚未收到消息时没有业务日志;保留这个终端,不要立即按 Ctrl+C。

另开终端 B,依次发送正常消息与空消息:

bash
source /opt/ros/jazzy/setup.bash
export ROS_DOMAIN_ID=21
ros2 topic pub --once -w 1 /chatter std_msgs/msg/String "{data: 'hello from terminal'}"
ros2 topic pub --once -w 1 /chatter std_msgs/msg/String "{data: ''}"

预期输出:终端 B 的两条命令各发布一条消息并退出;-w 1 会先等待至少一个匹配的订阅端。终端 A 应依次显示如下日志,其中 <TIME> 是实际运行时的时间戳:

text
[INFO] [<TIME>] [chatter_listener]: 第1条消息:hello from terminal
[WARN] [<TIME>] [chatter_listener]: 收到空字符串,跳过处理

第二条警告本身证明回调已经触发,不能把“没有增加有效消息计数”误判为“没有接收到消息”。

没有触发时如何定位

保持终端 A 的订阅者运行,等终端 B 的一次性发布命令退出后,在终端 B 检查话题:

bash
ros2 topic info /chatter

预期输出(没有其他节点使用该话题时):

text
Type: std_msgs/msg/String
Publisher count: 0
Subscription count: 1

发布进程已退出,所以发布者计数为 0;订阅进程仍在,所以订阅者计数为 1。如果有其他发布者或订阅者,计数会不同。排查时按以下顺序检查:

  1. Subscription count 为 0:检查终端 A 是否仍在运行、订阅话题是否写成 /chatter,以及命令是否在相同通信域执行。
  2. 终端 B 一直停在等待匹配:检查两端 ROS_DOMAIN_ID、话题类型和 QoS 兼容性;使用 ros2 topic info /chatter --verbose 查看端点详情。
  3. 发布成功而终端 A 没有日志:检查程序是否执行 rclpy.spin(node),是否在发布之前启动,以及回调是否被耗时操作阻塞。

正常消息触发 INFO、空消息触发 WARN,说明消息已跨进程到达 Python 回调;业务是否计数,应在回调内部单独判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在订阅回调中处理消息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通