第118篇 ROS2动态重配置——运行时改变系统行为-开发者社区

面试被问："ROS2里怎么做动态重配置？就是运行时改参数让节点立即生效那种。"

我说"用参数回调就行"。面试官说："ROS1有dynamic_reconfigure包，ROS2里对应的方案是什么？有没有图形化界面？"

这个问题我确实没研究过。ROS2的动态重配置和ROS1差别挺大，今天把这块讲清楚。

从ROS1的dynamic_reconfigure说起

用过ROS1的人应该对dynamic_reconfigure有印象。你在.cfg文件里定义参数、范围、描述，编译之后自动生成图形界面（rqt_reconfigure）。拖动滑块就能实时调参，节点立即生效。

这个工具在调PID参数、调整视觉算法阈值的时候特别好用。但ROS1的dynamic_reconfigure有几个问题：需要额外的.cfg文件、需要重新编译、参数类型受限、和ROS2的参数系统不兼容。

ROS2的方案：参数系统 + rqt_reconfigure

ROS2没有重新造轮子，而是把动态重配置的功能集成到了参数系统里。你只需要正常声明参数、注册参数回调，然后用rqt_reconfigure就能获得图形化调参界面。

前提是参数声明的时候加上描述信息：

from rcl_interfaces.msg import ParameterDescriptor from rcl_interfaces.msg import FloatingPointRange self.declare_parameter( 'kp', 1.5, ParameterDescriptor( description='比例增益', floating_point_range=[FloatingPointRange( from_value=0.0, to_value=10.0, step=0.1)] ))

description是参数的描述文字，会显示在rqt界面上。floating_point_range定义了参数的取值范围和步长，rqt会自动生成滑块控件。

整数参数用IntegerRange，用法一样。

rqt_reconfigure的使用

启动方式很简单：

ros2 run rqt_reconfigure rqt_reconfigure

打开之后，左边列出所有正在运行的节点。点击一个节点，右边显示它的所有参数。每个参数都有描述信息、当前值和范围限制。拖动滑块或者修改数值，参数立即生效。

对于有多个参数的复杂系统，这个界面能极大提高调试效率。你不需要记住参数名字，不需要敲命令行，直接拖就行。

参数回调的正确写法

动态重配置的关键是参数回调。当rqt修改了参数值，回调函数会被调用，你需要在这里把新值同步到实际使用的变量上。

from rcl_interfaces.srv import SetParameters def parameters_callback(self, params): result = SetParameters.Result() result.successful = True for param in params: if param.name == 'kp': if param.value < 0.0: result.successful = False result.reason = 'kp不能为负' return result self.kp = param.value self.get_logger().info(f'kp = {self.kp}') elif param.name == 'detection_threshold': self.threshold = param.value elif param.name == 'use_lidar': self.use_lidar = bool(param.value) return result

几个注意事项：

回调里不要做耗时操作。参数回调是在通信线程中调用的，如果阻塞了会影响整个节点的通信。如果需要做耗时操作，设个标志位，在主循环里处理。

校验逻辑要严谨。用户可能通过命令行设置超出范围的值，你的回调必须能处理这种情况。

日志要打好。参数被修改的时候记录一条日志，调试的时候能省很多事。

实际应用场景

动态重配置在机器人项目中有几个典型的使用场景。

PID调参。这是最经典的场景。调PID参数的时候，你需要实时看到系统响应，然后微调参数。用rqt_reconfigure拖动滑块，比改代码重新编译快太多了。

视觉算法阈值。颜色分割的HSV范围、目标检测的置信度阈值、点云滤波的距离范围。这些参数在不同环境下需要不同的值，运行时可调能让你快速找到合适的参数。

行为切换。比如机器人在不同地形上行走，需要切换不同的步态参数。你可以设一个参数terrain_type，在界面上切换，节点根据这个参数选择不同的控制策略。

参数组和命名

参数多的时候，可以用参数组来组织：

self.declare_parameter('pid.kp', 1.5) self.declare_parameter('pid.ki', 0.01) self.declare_parameter('pid.kd', 0.2) self.declare_parameter('sensor.rate', 10.0) self.declare_parameter('sensor.threshold', 0.5)

在rqt_reconfigure里，这些参数会按前缀分组显示，看起来更清晰。

参数持久化

调好的参数如果因为重启丢了，那就白调了。ROS2支持参数持久化，在节点关闭时自动保存参数，下次启动时自动加载。

在launch文件中设置output参数为screen，然后用ros2 param dump手动保存。更自动化的做法是写一个脚本，在系统关闭时执行dump，启动时执行load。

还有一种方式是用参数覆盖文件。把调好的参数保存到YAML文件里，提交到Git版本控制。每次启动都加载这个文件，保证参数一致性。团队里所有人都用同一套参数，避免"我这能跑你那不行"的尴尬问题。

参数管理的最佳实践

在团队项目中，参数管理容易出问题。几个人各自调参，最后谁也不知道哪个版本的效果最好。建议建立一个参数管理流程：

第一，所有可调参数都用declare_parameter声明，加上描述和范围限制。这样用rqt_reconfigure调参时能看到每个参数的含义和合法范围。

第二，把参数分两类：调试参数和部署参数。调试参数在开发阶段频繁调整，不需要提交。部署参数是经过验证的最优值，提交到Git。

第三，每次重要实验前用ros2 param dump导出当前参数快照，标注实验目的和日期。几个月后你想复现某个效果，直接加载当时的参数文件就行。

面试中怎么聊

面试官问动态重配置，你可以说："ROS2把动态重配置集成到了参数系统中。通过declare_parameter声明参数时加上描述和范围信息，配合add_on_set_parameters_callback注册回调来同步参数值。rqt_reconfigure提供图形化界面，支持滑块调参。和ROS1的dynamic_reconfigure相比，不需要额外的配置文件和编译步骤，使用更灵活。"