ROS Action从入门到精通：一个自定义Timer.action的完整开发、编译与调试避坑指南

ROS Action深度实战：从Timer.action开发到高级调试技巧全解析

在机器人开发中，任务执行往往需要长时间运行且状态可监控。想象一下让机器人移动到指定位置的任务——如果使用传统的服务调用，开发者无法获知移动进度，也无法中途取消任务。这正是ROS Action大显身手的场景。不同于简单的服务调用，Action提供了任务目标、实时反馈和最终结果的全生命周期管理，特别适合需要持续交互的复杂任务。

本文将带您从零构建一个完整的Timer Action示例，不仅涵盖基础实现，更会深入编译原理和调试技巧。无论您是第一次接触ROS Action的新手，还是遇到过诡异编译错误的老手，都能在这里找到实用的解决方案。

1. 环境准备与Action文件定义

1.1 创建ROS工作空间和功能包

首先确保已安装ROS和actionlib包。推荐使用Ubuntu 20.04和ROS Noetic版本。创建工作空间的命令如下：

mkdir -p ~/timer_action_ws/src cd ~/timer_action_ws/ catkin_make source devel/setup.bash

创建功能包时，务必添加正确的依赖项。许多初学者常在这里出错：

cd ~/timer_action_ws/src catkin_create_pkg timer_action_tutorial actionlib actionlib_msgs roscpp std_msgs

关键点在于：

• actionlib提供Action服务器和客户端的实现
• actionlib_msgs包含Action通信所需的基础消息类型

1.2 定义Timer.action文件

在功能包中创建action目录，并新建Timer.action文件：

# 目标定义 - 客户端发送给服务器的请求 duration time_to_wait --- # 结果定义 - 任务完成后服务器返回给客户端 duration time_elapsed uint32 updates_sent --- # 反馈定义 - 任务执行过程中的定期更新 duration time_elapsed duration time_remaining

这个文件定义了三个核心部分：

1. Goal：客户端指定的等待时间
2. Result：实际等待时间和反馈次数
3. Feedback：执行过程中的已等待时间和剩余时间

注意：三个部分之间用---分隔，这是.action文件的固定语法格式。错误的间隔符号会导致后续编译失败。

2. 配置编译系统与消息生成

2.1 修改package.xml

在package.xml中添加必要的依赖项，这是最容易被忽视的步骤：

<build_depend>actionlib</build_depend> <build_depend>actionlib_msgs</build_depend> <exec_depend>actionlib</exec_depend> <exec_depend>actionlib_msgs</exec_depend>

常见错误包括：

• 遗漏actionlib_msgs导致消息生成失败
• 将依赖项放在错误的位置（如把build_depend放在exec_depend之后）

2.2 配置CMakeLists.txt

CMakeLists.txt的配置更为复杂，需要多个关键修改：

find_package(catkin REQUIRED COMPONENTS actionlib actionlib_msgs roscpp std_msgs ) add_action_files( DIRECTORY action FILES Timer.action ) generate_messages( DEPENDENCIES actionlib_msgs std_msgs ) catkin_package( CATKIN_DEPENDS actionlib actionlib_msgs roscpp std_msgs )

编译时可能遇到的典型错误及解决方案：

2.3 理解生成的消息结构

成功编译后，在devel/include/your_package目录下会生成7个消息文件：

1. TimerAction.msg - 完整Action定义
2. TimerActionGoal.msg - 目标消息包装
3. TimerActionResult.msg - 结果消息包装
4. TimerActionFeedback.msg - 反馈消息包装
5. TimerGoal.msg - 纯目标定义
6. TimerResult.msg - 纯结果定义
7. TimerFeedback.msg - 纯反馈定义

关键区别：

• TimerGoalvsTimerActionGoal：前者只包含目标数据，后者添加了标准Action头部信息
• 实际编程中，通常直接使用TimerGoal而非TimerActionGoal

3. Python实现Action服务器与客户端

3.1 基础Action服务器实现

创建scripts/timer_action_server.py：

#!/usr/bin/env python import rospy import time import actionlib from timer_action_tutorial.msg import TimerAction, TimerGoal, TimerResult def execute_callback(goal): start_time = time.time() time.sleep(goal.time_to_wait.to_sec()) result = TimerResult() result.time_elapsed = rospy.Duration.from_sec(time.time() - start_time) result.updates_sent = 0 server.set_succeeded(result, "Timer completed successfully") rospy.init_node('timer_action_server') server = actionlib.SimpleActionServer('timer', TimerAction, execute_callback, False) server.start() rospy.spin()

设置执行权限并测试：

chmod +x scripts/timer_action_server.py rosrun timer_action_tutorial timer_action_server.py

3.2 增强型Action服务器

基础版本缺乏反馈和中断处理，改进后的版本：

def execute_callback(goal): if goal.time_to_wait.to_sec() > 60: result = TimerResult() result.time_elapsed = rospy.Duration(0) result.updates_sent = 0 server.set_aborted(result, "Timer aborted: too long duration") return start_time = time.time() update_count = 0 while (time.time() - start_time) < goal.time_to_wait.to_sec(): if server.is_preempt_requested(): result = TimerResult() result.time_elapsed = rospy.Duration.from_sec(time.time() - start_time) result.updates_sent = update_count server.set_preempted(result, "Timer preempted") return feedback = TimerFeedback() feedback.time_elapsed = rospy.Duration.from_sec(time.time() - start_time) feedback.time_remaining = rospy.Duration.from_sec( goal.time_to_wait.to_sec() - feedback.time_elapsed.to_sec()) server.publish_feedback(feedback) update_count += 1 time.sleep(1.0) result = TimerResult() result.time_elapsed = rospy.Duration.from_sec(time.time() - start_time) result.updates_sent = update_count server.set_succeeded(result, "Timer completed")

3.3 完整功能的Action客户端

创建scripts/timer_action_client.py：

#!/usr/bin/env python import rospy import actionlib from timer_action_tutorial.msg import TimerAction, TimerGoal, TimerResult, TimerFeedback def feedback_cb(feedback): rospy.loginfo("[Feedback] Elapsed: %.2fs, Remaining: %.2fs", feedback.time_elapsed.to_sec(), feedback.time_remaining.to_sec()) rospy.init_node('timer_action_client') client = actionlib.SimpleActionClient('timer', TimerAction) client.wait_for_server() goal = TimerGoal() goal.time_to_wait = rospy.Duration.from_sec(10.0) client.send_goal(goal, feedback_cb=feedback_cb) client.wait_for_result() rospy.loginfo("[Result] State: %d", client.get_state()) rospy.loginfo("[Result] Status: %s", client.get_goal_status_text()) rospy.loginfo("[Result] Elapsed: %.2fs", client.get_result().time_elapsed.to_sec()) rospy.loginfo("[Result] Updates: %d", client.get_result().updates_sent)

测试不同场景：

• 正常完成（10秒等待）
• 中断任务（在另一个终端执行rostopic pub /timer/cancel actionlib_msgs/GoalID -- {}）
• 超长任务（设置60秒以上触发服务器中止）

4. 高级调试技巧与最佳实践

4.1 常见问题排查指南

当Action无法正常工作时，可以按照以下步骤排查：

1. 检查话题列表：

   rostopic list | grep timer

   应该看到：

   /timer/cancel /timer/feedback /timer/goal /timer/result /timer/status

2. 检查消息类型：

   rostopic info /timer/goal rosmsg show timer_action_tutorial/TimerActionGoal

3. 手动发布测试消息：

   rostopic pub /timer/goal timer_action_tutorial/TimerActionGoal "header: seq: 0 stamp: {secs: 0, nsecs: 0} frame_id: '' goal_id: stamp: {secs: 0, nsecs: 0} id: '' goal: time_to_wait: {secs: 5, nsecs: 0}"

4.2 性能优化建议

1. 反馈频率控制：

   • 避免高频反馈（>10Hz）造成网络拥堵
   • 重要状态变化时立即反馈，常规状态可降低频率

2. 资源管理：

   def cleanup(): if server.is_active(): server.set_aborted(None, "Shutting down") rospy.on_shutdown(cleanup)

3. 多Action协作：

   • 使用actionlib_tools中的goal_id_generator
   • 实现Action之间的状态同步

4.3 可视化监控工具

1. rqt_action：

   rosrun rqt_action rqt_action

   提供图形界面查看Action状态

2. rqt_console：

   rosrun rqt_console rqt_console

   查看Action相关的日志消息

3. 自定义监控节点：

   def status_cb(status): for s in status.status_list: print(f"Goal {s.goal_id.id}: {actionlib_msgs.GoalStatus.to_string(s.status)}") rospy.Subscriber('/timer/status', actionlib_msgs.GoalStatusArray, status_cb)

在实际项目中，Action的稳定性和可靠性直接影响整个机器人系统的表现。我曾在一个导航项目中遇到Action消息丢失的问题，最终发现是因为网络带宽不足导致大尺寸的反馈消息被丢弃。解决方案是优化反馈内容，只传输必要数据，并将大尺寸数据通过其他方式传输。