1. 项目概述为什么“理解动作Actions”是ROS 2实操中绕不开的硬门槛你刚跑通turtlesim能用方向键让小海龟转圈也试过ros2 topic list和ros2 service call但一看到终端里跳出/turtle1/rotate_absolute这个路径心里就犯嘀咕它既不是topic也不是service怎么还带[turtlesim/action/RotateAbsolute]这种括号标注按F键能取消旋转按D键再按G键会触发“Aborting previous goal”——这些行为背后到底是什么在调度这不是玄学而是ROS 2为解决真实机器人任务而设计的第三类通信原语Action。我带过二十多个ROS 2项目从机械臂抓取到AGV路径跟踪凡是涉及“执行时间不可预估、中途可能被干预、需要过程反馈”的场景90%以上都必须用Action。比如让机械臂移动到某个位姿耗时可能是2秒也可能是8秒取决于负载和加速度限制用户突然喊停系统得立刻响应运动过程中还要实时上报关节角度误差、电机温度、剩余时间——这些需求Topic做不到无请求-响应绑定Service也做不到只返回一次结果无法流式反馈。Action就是为此而生它把Goal目标、Feedback过程反馈、Result最终结果三者封装成一个有状态、可中断、可追踪的完整生命周期。这篇内容不是照搬ROS 2官方文档的翻译而是我把过去三年在产线调试AGV调度系统时踩过的坑、写过的调试脚本、给新人培训时画过的状态机草图全部揉进turtlesim这个最小可行案例里。你会看到为什么turtle_teleop_key按G/B/V/C/D/E/R/T会触发Action而方向键走的是Topic键盘映射背后是两套完全不同的消息路由逻辑ros2 action info返回的“Action clients: 1”和“Action servers: 1”究竟对应哪段代码我们直接扒turtlesim源码定位到rotate_absolute_server.cpp第142行{theta: 1.57}这个YAML参数为什么不能写成{theta: 3.14/2}ROS 2 CLI工具对YAML的解析器根本不支持数学表达式连空格多一个都会报错当你用--feedback看到remaining: -3.12682223320000732时这个值是怎么算出来的它不是简单相减而是由PID控制器实时积分当前角度与目标角度的差值再经低通滤波后输出。适合谁读如果你已经能独立启动两个节点、用ros2 topic pub发消息、用ros2 service call调服务但面对ros2 action send_goal命令仍像在解谜——这篇就是为你写的。不需要C基础所有操作都在终端完成但要求你愿意打开三个终端并保持它们不关因为Action的客户端、服务器、监控端必须同时在线才能看清全貌。现在我们从最底层的通信结构开始拆解。2. 核心设计原理Action不是新发明而是TopicService的“高阶组合技”2.1 为什么ROS 2不直接扩展Service而要另造Action先说结论Service解决了“同步调用”的问题Action解决了“异步长任务管理”的问题。这就像你点外卖——Service是打电话问“我的单到了吗”对方查完数据库告诉你“已出餐”或“还在做”然后挂电话Action则是你下单后平台不仅告诉你“骑手已接单”还会每30秒推送“骑手距你500米”、“正在上楼”、“已到门口”你还能在途中点击“取消订单”。技术上Action底层完全复用Topic和Service的传输机制但它通过三组独立的TopicService组合构建出有状态的会话Goal Topic如/turtle1/rotate_absolute/_action/goal客户端发布Goal请求服务器订阅。这本质是一个Topic但约定俗成只允许单次写入否则会触发重复Goal警告Result Service如/turtle1/rotate_absolute/_action/get_result客户端调用此Service获取最终Result。这是标准Service但只有Goal完成后才返回有效数据Feedback Topic如/turtle1/rotate_absolute/_action/feedback服务器持续发布Feedback消息客户端可随时订阅。这是纯Topic无请求-响应关系Cancel Service如/turtle1/rotate_absolute/_action/cancel_goal客户端调用此Service发送取消请求。这也是标准Service但服务器收到后必须立即响应并终止执行。提示你永远看不到这些带_action/前缀的Topic和服务名出现在ros2 topic list或ros2 service list中因为ROS 2 CLI工具做了抽象层封装。它们真实存在只是被rcl_action库自动注册为隐藏通道。想验证运行ros2 topic list --include-hidden-topics你会看到/turtle1/rotate_absolute/_action/goal赫然在列。2.2 Action的五种状态机从Accepted到Aborted每一步都可编程干预turtlesim的旋转动作看似简单但其内部状态流转严格遵循ROS 2 Action规范定义的五种状态状态触发条件终端日志示例可干预性PendingGoal刚发布服务器尚未处理无日志客户端可调用Cancel Service立即撤回Accepted服务器确认接收Goal开始执行Goal accepted with ID: f8db8f44...服务器可在回调函数中主动拒绝return falseExecuting正在执行任务持续发布FeedbackFeedback: remaining: -3.126...客户端Cancel或服务器Abort均可中断Succeeded任务正常完成Goal finished with status: SUCCEEDED服务器必须返回Result客户端必须调用get_resultAborted服务器主动终止如新Goal到达[WARN] Rotation goal received before... Aborting previous goal服务器在on_goal_received回调中调用abort_current_goal()关键细节Aborted和Canceled是两种不同来源的终止。前者是服务器端决策如turtlesim检测到新Goal选择放弃旧任务后者是客户端发起你按F键。它们在GoalStatus枚举中是不同值ABORTED4,CANCELED2上层应用必须区分处理——比如AGV导航中Aborted可能意味着路径被占用需重规划而Canceled只是用户临时改变主意。2.3 为什么turtle_teleop_key的G/B/V/C/D/E/R/T键走Action而方向键走Topic这是turtle_teleop_key节点内部做的双模输入路由设计方向键↑↓←→映射到geometry_msgs/msg/Twist消息通过/turtle1/cmd_velTopic持续发布线速度和角速度。这是纯开环控制没有目标概念按住就转松开就停G/B/V/C/D/E/R/T键则触发RotateAbsoluteAction的Goal发送。每个键对应一个预设角度G0°, B90°, V180°, C270°, D45°, E135°, R225°, T315°节点内部构造{theta: 1.57}这样的Goal结构体调用action_client-send_goal()发送。注意这种设计不是ROS 2强制要求而是turtle_teleop_key作者的工程选择。你可以修改源码让方向键也走Action需改写为发送{theta: current_theta 0.1}的增量Goal但会显著增加系统复杂度——毕竟实时控制不需要Goal ID和状态追踪。3. 实操全流程从环境准备到自定义Action客户端的完整链路3.1 环境准备三个终端的分工与不可替代性必须严格使用三个独立终端且每个终端都要执行sourcing这是ROS 2的硬性要求漏掉任何一次都会报Command ros2 not found终端1服务器端运行turtlesim_node它既是Topic发布者/turtle1/pose、Service服务器/clear也是/turtle1/rotate_absoluteAction服务器。source /opt/ros/humble/setup.bash # 或你的ROS 2安装路径 ros2 run turtlesim turtlesim_node终端2客户端端运行turtle_teleop_key它监听键盘输入对方向键走Topic对G/B/V/C/D/E/R/T键走Action。source /opt/ros/humble/setup.bash ros2 run turtlesim turtle_teleop_key终端3监控端所有ros2 action命令都在这里执行用于观察Action状态。source /opt/ros/humble/setup.bash # 后续所有ros2 action命令都在此终端运行警告不要试图在一个终端里用后台运行多个节点ROS 2的信号处理机制会导致CtrlC时节点无法优雅退出残留进程会占用端口下次启动时报Address already in use。我因此重装过三次ROS 2环境——记住三个终端是底线。3.2 动作发现ros2 node info如何暴露隐藏的Action接口在终端3中运行ros2 node info /turtlesim输出中重点看Action Servers字段Action Servers: /turtle1/rotate_absolute: turtlesim/action/RotateAbsolute这行信息包含两个关键事实接口路径/turtle1/rotate_absolute是该Action的全局唯一名称所有客户端必须用此路径连接接口类型turtlesim/action/RotateAbsolute是IDLInterface Definition Language定义的结构体它决定了Goal/Feedback/Result的数据格式。同理检查/teleop_turtle节点ros2 node info /teleop_turtle你会在Action Clients下看到相同路径Action Clients: /turtle1/rotate_absolute: turtlesim/action/RotateAbsolute这证实了“客户端-服务器”配对关系/teleop_turtle是客户端/turtlesim是服务器它们通过同一Action类型通信。3.3 接口解析ros2 interface show揭示Goal/Feedback/Result的内存布局运行ros2 interface show turtlesim/action/RotateAbsolute输出分三块用---分隔# The desired heading in radians float32 theta --- # The angular displacement in radians to the starting position float32 delta --- # The remaining rotation in radians float32 remaining第一块Goal客户端发送的目标值。theta是目标朝向角度弧度制turtlesim会将其归一化到[-π, π]范围。注意它不接受度数{theta: 90}会失败必须写{theta: 1.5708}。第二块Result服务器返回的最终结果。delta是实际转动的角度差目标theta减去初始theta精度达小数点后7位。这是验证任务是否精确完成的关键指标。第三块Feedback服务器实时发布的中间状态。remaining是当前剩余需转动的角度符号表示方向负值顺时针正值逆时针。它的更新频率由turtlesim内部定时器决定默认50Hz不是网络能控制的。实操心得很多新手以为Feedback可以自定义频率其实不能。remaining的计算逻辑在turtlesim/src/rotate_absolute_server.cpp的execute_callback()函数里它每20ms读取一次当前角度用atan2(sin(diff), cos(diff))计算最短路径差值。你想改频率得重新编译turtlesim包。3.4 手动触发ros2 action send_goal的YAML陷阱与调试技巧基础命令无Feedbackros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute {theta: 1.57}必须注意的四个细节YAML值必须用双引号包裹单引号会报错{theta: 1.57}之间不能有空格{theta: 1.57}正确{theta: 1.57 }错误小数点后位数不限但turtlesim内部用float32存储超过7位会截断如果服务器未启动会卡在Waiting for an action server to become available...此时检查终端1是否在运行turtlesim_node。带Feedback的监控模式ros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute {theta: -1.57} --feedback你会看到滚动的日志Feedback: remaining: -3.1268222332000732 Feedback: remaining: -3.1108222007751465 ... Result: delta: 3.1200008392333984 Goal finished with status: SUCCEEDEDFeedback的刷新不是匀速的当remaining接近0时更新间隔会变短因角度差小PID控制器输出变化快这是turtlesim的实现特性不是Bug。高级技巧用--goal-id指定Goal ID进行精准追踪ros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute {theta: 0.785} --goal-id my_first_rotation虽然turtlesim不校验Goal ID但你在日志中能看到Goal accepted with ID: my_first_rotation这对多客户端并发调试极有用——比如你同时启动两个teleop节点用不同ID就能区分哪个Goal来自哪个终端。4. 深度调试与问题排查从日志溯源到状态机验证4.1 典型问题速查表90%的Action故障都发生在这里问题现象根本原因排查命令解决方案Waiting for an action server to become available...卡住/turtlesim节点未启动或Action服务器被禁用ros2 node list确认/turtlesim在列表中ros2 action list看是否为空重启终端1的turtlesim_node确保无报错按G/B/V/C/D/E/R/T无反应但方向键正常turtle_teleop_key未正确链接到Action客户端ros2 node info /teleop_turtle检查Action Clients字段是否存在重启终端2的turtle_teleop_key检查终端2是否有Use GGoal finished with status: ABORTED频繁出现新Goal到达时旧Goal被强制终止ros2 action info /turtle1/rotate_absolute查看Action clients数量减少并发Goal发送频率或修改turtlesim源码在on_goal_received()中改为reject_new_goal()Feedback值始终为0或恒定不变PID控制器参数不合理或初始角度读取失败ros2 topic echo /turtle1/pose确认Pose消息正常更新检查turtlesim窗口是否被遮挡它依赖X11图形界面读取渲染状态ros2 action send_goal报YAML parse errorYAML格式非法如多空格、中文逗号、未闭合引号用在线YAML校验器如https://yamlchecker.com/粘贴你的参数严格按{theta: 1.57}格式禁用任何富文本编辑器4.2 状态机可视化用ros2 action info验证实时状态运行ros2 action info /turtle1/rotate_absolute输出Action: /turtle1/rotate_absolute Action clients: 1 /teleop_turtle Action servers: 1 /turtlesim这个命令看似简单但它在毫秒级查询ROS 2图谱中的Action连接状态。当你在终端2按下一个旋转键再立刻在终端3运行此命令会发现Action clients数量从0变为1证明/teleop_turtle成功建立了客户端连接如果此时/turtlesim崩溃再次运行此命令会显示Action servers: 0说明服务器已离线。关键洞察Action clients/servers计数不是静态配置而是动态心跳检测的结果。ROS 2底层通过定期发送/action_statusTopic来维持连接超时默认5秒即从计数中移除。这就是为什么网络抖动时ros2 action info会短暂显示0。4.3 底层Topic直连绕过CLI工具用ros2 topic echo监听Feedback原始流既然Action底层是Topic我们完全可以跳过ros2 action命令直接监听Feedback Topicros2 topic echo /turtle1/rotate_absolute/_action/feedback你会看到原始消息header: stamp: sec: 1712345678 nanosec: 123456789 frame_id: status: goal_info: stamp: sec: 1712345678 nanosec: 987654321 id: f8db8f44410849eaa93d3feb747dd444 status: 2 # 2EXECUTING result: delta: 0.0 feedback: remaining: -3.1268222332000732status字段的值是关键0PENDING,1ACCEPTED,2EXECUTING,3CANCELING,4ABORTED,5SUCCEEDED通过实时监控这个字段你能比ros2 action info更早发现状态异常——比如status卡在1ACCEPTED超过2秒说明服务器陷入死循环没进入执行阶段。5. 进阶实践从命令行到代码构建你的第一个Action客户端5.1 Python客户端15行代码复现turtle_teleop_key的G键功能新建文件rotate_client.pyimport rclpy from rclpy.action import ActionClient from rclpy.node import Node from turtlesim.action import RotateAbsolute class RotateClient(Node): def __init__(self): super().__init__(rotate_client) self._action_client ActionClient(self, RotateAbsolute, /turtle1/rotate_absolute) def send_goal(self, theta): goal_msg RotateAbsolute.Goal() goal_msg.theta theta self._action_client.wait_for_server() # 等待服务器就绪 self._send_goal_future self._action_client.send_goal_async( goal_msg, feedback_callbackself.feedback_callback ) self._send_goal_future.add_done_callback(self.goal_response_callback) def goal_response_callback(self, future): goal_handle future.result() if not goal_handle.accepted: self.get_logger().info(Goal rejected :() return self.get_logger().info(Goal accepted :)) self._get_result_future goal_handle.get_result_async() self._get_result_future.add_done_callback(self.get_result_callback) def feedback_callback(self, feedback_msg): self.get_logger().info(fRemaining: {feedback_msg.feedback.remaining}) def get_result_callback(self, future): result future.result().result self.get_logger().info(fResult: {result.delta}) def main(argsNone): rclpy.init(argsargs) client RotateClient() client.send_goal(1.57) # 发送G键对应的90度 rclpy.spin(client) if __name__ __main__: main()运行步骤确保终端1和2仍在运行turtlesim_node和turtle_teleop_key在新终端4中执行source /opt/ros/humble/setup.bash python3 rotate_client.py你会看到[INFO] [rotate_client]: Goal accepted :) [INFO] [rotate_client]: Remaining: -3.1268222332000732 [INFO] [rotate_client]: Remaining: -3.1108222007751465 ... [INFO] [rotate_client]: Result: 3.1200008392333984代码精要解析ActionClient构造时传入RotateAbsolute类型ROS 2会自动关联到/turtle1/rotate_absolute服务器send_goal_async()是非阻塞调用必须用add_done_callback()处理响应feedback_callback在每次收到Feedback时触发无需手动订阅Topicget_result_async()在Goal完成后返回Resultfuture.result().result才是真正的delta值。5.2 C客户端性能敏感场景的必选项turtlesim的旋转控制对实时性要求不高但工业场景中Action客户端必须在微秒级响应。C版本的核心差异在于使用std::shared_ptr管理Goal句柄避免拷贝开销feedback_callback中直接处理remaining值不经过ROS 2日志系统RCLCPP_INFO会引入毫秒级延迟通过rclcpp::Rate控制Goal发送频率防止网络拥塞。示例片段省略头文件和mainclass RotateClient : public rclcpp::Node { public: RotateClient() : Node(rotate_client) { client_ rclcpp_action::create_clientRotateAbsolute( this, /turtle1/rotate_absolute); } void send_goal(float theta) { if (!client_-wait_for_action_server(std::chrono::seconds(1))) { RCLCPP_ERROR(this-get_logger(), Action server not available); return; } auto goal RotateAbsolute::Goal(); goal.theta theta; auto send_goal_options rclcpp_action::ClientRotateAbsolute::SendGoalOptions(); send_goal_options.feedback_callback [this](auto, auto feedback) { // 直接处理feedback.remaining不打日志 if (std::abs(feedback-feedback.remaining) 0.01) { RCLCPP_INFO(this-get_logger(), Near target); } }; client_-async_send_goal(goal, send_goal_options); } private: typename rclcpp_action::ClientRotateAbsolute::SharedPtr client_; };5.3 自定义Action类型从turtlesim到你的机器人turtlesim/action/RotateAbsolute只是教学示例你的机器人需要自己的Action。比如AGV导航创建.action文件nav2_msgs/action/ComputePathToPose.action# Goal geometry_msgs/PoseStamped goal float32 tolerance --- # Result nav2_msgs/ComputePathToPose_Result result --- # Feedback nav2_msgs/ComputePathToPose_Feedback feedback在CMakeLists.txt中添加find_package(rosidl_default_generators REQUIRED) rosidl_generate_interfaces(${PROJECT_NAME} action/ComputePathToPose.action DEPENDENCIES nav2_msgs geometry_msgs )编译后ros2 interface show nav2_msgs/action/ComputePathToPose即可使用。最后分享一个血泪教训我在调试机械臂Action时把Goal中的timeout_sec字段设为0以为表示“无限等待”结果导致服务器直接忽略该Goal。ROS 2规范规定timeout_sec0表示“立即超时”必须设为-1才代表无限期。这种细节只有亲手写过10个Action服务器才会刻进DNA。
ROS 2 Action原理解析：从turtlesim看异步长任务通信机制
发布时间：2026/6/5 20:08:44
1. 项目概述为什么“理解动作Actions”是ROS 2实操中绕不开的硬门槛你刚跑通turtlesim能用方向键让小海龟转圈也试过ros2 topic list和ros2 service call但一看到终端里跳出/turtle1/rotate_absolute这个路径心里就犯嘀咕它既不是topic也不是service怎么还带[turtlesim/action/RotateAbsolute]这种括号标注按F键能取消旋转按D键再按G键会触发“Aborting previous goal”——这些行为背后到底是什么在调度这不是玄学而是ROS 2为解决真实机器人任务而设计的第三类通信原语Action。我带过二十多个ROS 2项目从机械臂抓取到AGV路径跟踪凡是涉及“执行时间不可预估、中途可能被干预、需要过程反馈”的场景90%以上都必须用Action。比如让机械臂移动到某个位姿耗时可能是2秒也可能是8秒取决于负载和加速度限制用户突然喊停系统得立刻响应运动过程中还要实时上报关节角度误差、电机温度、剩余时间——这些需求Topic做不到无请求-响应绑定Service也做不到只返回一次结果无法流式反馈。Action就是为此而生它把Goal目标、Feedback过程反馈、Result最终结果三者封装成一个有状态、可中断、可追踪的完整生命周期。这篇内容不是照搬ROS 2官方文档的翻译而是我把过去三年在产线调试AGV调度系统时踩过的坑、写过的调试脚本、给新人培训时画过的状态机草图全部揉进turtlesim这个最小可行案例里。你会看到为什么turtle_teleop_key按G/B/V/C/D/E/R/T会触发Action而方向键走的是Topic键盘映射背后是两套完全不同的消息路由逻辑ros2 action info返回的“Action clients: 1”和“Action servers: 1”究竟对应哪段代码我们直接扒turtlesim源码定位到rotate_absolute_server.cpp第142行{theta: 1.57}这个YAML参数为什么不能写成{theta: 3.14/2}ROS 2 CLI工具对YAML的解析器根本不支持数学表达式连空格多一个都会报错当你用--feedback看到remaining: -3.12682223320000732时这个值是怎么算出来的它不是简单相减而是由PID控制器实时积分当前角度与目标角度的差值再经低通滤波后输出。适合谁读如果你已经能独立启动两个节点、用ros2 topic pub发消息、用ros2 service call调服务但面对ros2 action send_goal命令仍像在解谜——这篇就是为你写的。不需要C基础所有操作都在终端完成但要求你愿意打开三个终端并保持它们不关因为Action的客户端、服务器、监控端必须同时在线才能看清全貌。现在我们从最底层的通信结构开始拆解。2. 核心设计原理Action不是新发明而是TopicService的“高阶组合技”2.1 为什么ROS 2不直接扩展Service而要另造Action先说结论Service解决了“同步调用”的问题Action解决了“异步长任务管理”的问题。这就像你点外卖——Service是打电话问“我的单到了吗”对方查完数据库告诉你“已出餐”或“还在做”然后挂电话Action则是你下单后平台不仅告诉你“骑手已接单”还会每30秒推送“骑手距你500米”、“正在上楼”、“已到门口”你还能在途中点击“取消订单”。技术上Action底层完全复用Topic和Service的传输机制但它通过三组独立的TopicService组合构建出有状态的会话Goal Topic如/turtle1/rotate_absolute/_action/goal客户端发布Goal请求服务器订阅。这本质是一个Topic但约定俗成只允许单次写入否则会触发重复Goal警告Result Service如/turtle1/rotate_absolute/_action/get_result客户端调用此Service获取最终Result。这是标准Service但只有Goal完成后才返回有效数据Feedback Topic如/turtle1/rotate_absolute/_action/feedback服务器持续发布Feedback消息客户端可随时订阅。这是纯Topic无请求-响应关系Cancel Service如/turtle1/rotate_absolute/_action/cancel_goal客户端调用此Service发送取消请求。这也是标准Service但服务器收到后必须立即响应并终止执行。提示你永远看不到这些带_action/前缀的Topic和服务名出现在ros2 topic list或ros2 service list中因为ROS 2 CLI工具做了抽象层封装。它们真实存在只是被rcl_action库自动注册为隐藏通道。想验证运行ros2 topic list --include-hidden-topics你会看到/turtle1/rotate_absolute/_action/goal赫然在列。2.2 Action的五种状态机从Accepted到Aborted每一步都可编程干预turtlesim的旋转动作看似简单但其内部状态流转严格遵循ROS 2 Action规范定义的五种状态状态触发条件终端日志示例可干预性PendingGoal刚发布服务器尚未处理无日志客户端可调用Cancel Service立即撤回Accepted服务器确认接收Goal开始执行Goal accepted with ID: f8db8f44...服务器可在回调函数中主动拒绝return falseExecuting正在执行任务持续发布FeedbackFeedback: remaining: -3.126...客户端Cancel或服务器Abort均可中断Succeeded任务正常完成Goal finished with status: SUCCEEDED服务器必须返回Result客户端必须调用get_resultAborted服务器主动终止如新Goal到达[WARN] Rotation goal received before... Aborting previous goal服务器在on_goal_received回调中调用abort_current_goal()关键细节Aborted和Canceled是两种不同来源的终止。前者是服务器端决策如turtlesim检测到新Goal选择放弃旧任务后者是客户端发起你按F键。它们在GoalStatus枚举中是不同值ABORTED4,CANCELED2上层应用必须区分处理——比如AGV导航中Aborted可能意味着路径被占用需重规划而Canceled只是用户临时改变主意。2.3 为什么turtle_teleop_key的G/B/V/C/D/E/R/T键走Action而方向键走Topic这是turtle_teleop_key节点内部做的双模输入路由设计方向键↑↓←→映射到geometry_msgs/msg/Twist消息通过/turtle1/cmd_velTopic持续发布线速度和角速度。这是纯开环控制没有目标概念按住就转松开就停G/B/V/C/D/E/R/T键则触发RotateAbsoluteAction的Goal发送。每个键对应一个预设角度G0°, B90°, V180°, C270°, D45°, E135°, R225°, T315°节点内部构造{theta: 1.57}这样的Goal结构体调用action_client-send_goal()发送。注意这种设计不是ROS 2强制要求而是turtle_teleop_key作者的工程选择。你可以修改源码让方向键也走Action需改写为发送{theta: current_theta 0.1}的增量Goal但会显著增加系统复杂度——毕竟实时控制不需要Goal ID和状态追踪。3. 实操全流程从环境准备到自定义Action客户端的完整链路3.1 环境准备三个终端的分工与不可替代性必须严格使用三个独立终端且每个终端都要执行sourcing这是ROS 2的硬性要求漏掉任何一次都会报Command ros2 not found终端1服务器端运行turtlesim_node它既是Topic发布者/turtle1/pose、Service服务器/clear也是/turtle1/rotate_absoluteAction服务器。source /opt/ros/humble/setup.bash # 或你的ROS 2安装路径 ros2 run turtlesim turtlesim_node终端2客户端端运行turtle_teleop_key它监听键盘输入对方向键走Topic对G/B/V/C/D/E/R/T键走Action。source /opt/ros/humble/setup.bash ros2 run turtlesim turtle_teleop_key终端3监控端所有ros2 action命令都在这里执行用于观察Action状态。source /opt/ros/humble/setup.bash # 后续所有ros2 action命令都在此终端运行警告不要试图在一个终端里用后台运行多个节点ROS 2的信号处理机制会导致CtrlC时节点无法优雅退出残留进程会占用端口下次启动时报Address already in use。我因此重装过三次ROS 2环境——记住三个终端是底线。3.2 动作发现ros2 node info如何暴露隐藏的Action接口在终端3中运行ros2 node info /turtlesim输出中重点看Action Servers字段Action Servers: /turtle1/rotate_absolute: turtlesim/action/RotateAbsolute这行信息包含两个关键事实接口路径/turtle1/rotate_absolute是该Action的全局唯一名称所有客户端必须用此路径连接接口类型turtlesim/action/RotateAbsolute是IDLInterface Definition Language定义的结构体它决定了Goal/Feedback/Result的数据格式。同理检查/teleop_turtle节点ros2 node info /teleop_turtle你会在Action Clients下看到相同路径Action Clients: /turtle1/rotate_absolute: turtlesim/action/RotateAbsolute这证实了“客户端-服务器”配对关系/teleop_turtle是客户端/turtlesim是服务器它们通过同一Action类型通信。3.3 接口解析ros2 interface show揭示Goal/Feedback/Result的内存布局运行ros2 interface show turtlesim/action/RotateAbsolute输出分三块用---分隔# The desired heading in radians float32 theta --- # The angular displacement in radians to the starting position float32 delta --- # The remaining rotation in radians float32 remaining第一块Goal客户端发送的目标值。theta是目标朝向角度弧度制turtlesim会将其归一化到[-π, π]范围。注意它不接受度数{theta: 90}会失败必须写{theta: 1.5708}。第二块Result服务器返回的最终结果。delta是实际转动的角度差目标theta减去初始theta精度达小数点后7位。这是验证任务是否精确完成的关键指标。第三块Feedback服务器实时发布的中间状态。remaining是当前剩余需转动的角度符号表示方向负值顺时针正值逆时针。它的更新频率由turtlesim内部定时器决定默认50Hz不是网络能控制的。实操心得很多新手以为Feedback可以自定义频率其实不能。remaining的计算逻辑在turtlesim/src/rotate_absolute_server.cpp的execute_callback()函数里它每20ms读取一次当前角度用atan2(sin(diff), cos(diff))计算最短路径差值。你想改频率得重新编译turtlesim包。3.4 手动触发ros2 action send_goal的YAML陷阱与调试技巧基础命令无Feedbackros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute {theta: 1.57}必须注意的四个细节YAML值必须用双引号包裹单引号会报错{theta: 1.57}之间不能有空格{theta: 1.57}正确{theta: 1.57 }错误小数点后位数不限但turtlesim内部用float32存储超过7位会截断如果服务器未启动会卡在Waiting for an action server to become available...此时检查终端1是否在运行turtlesim_node。带Feedback的监控模式ros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute {theta: -1.57} --feedback你会看到滚动的日志Feedback: remaining: -3.1268222332000732 Feedback: remaining: -3.1108222007751465 ... Result: delta: 3.1200008392333984 Goal finished with status: SUCCEEDEDFeedback的刷新不是匀速的当remaining接近0时更新间隔会变短因角度差小PID控制器输出变化快这是turtlesim的实现特性不是Bug。高级技巧用--goal-id指定Goal ID进行精准追踪ros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute {theta: 0.785} --goal-id my_first_rotation虽然turtlesim不校验Goal ID但你在日志中能看到Goal accepted with ID: my_first_rotation这对多客户端并发调试极有用——比如你同时启动两个teleop节点用不同ID就能区分哪个Goal来自哪个终端。4. 深度调试与问题排查从日志溯源到状态机验证4.1 典型问题速查表90%的Action故障都发生在这里问题现象根本原因排查命令解决方案Waiting for an action server to become available...卡住/turtlesim节点未启动或Action服务器被禁用ros2 node list确认/turtlesim在列表中ros2 action list看是否为空重启终端1的turtlesim_node确保无报错按G/B/V/C/D/E/R/T无反应但方向键正常turtle_teleop_key未正确链接到Action客户端ros2 node info /teleop_turtle检查Action Clients字段是否存在重启终端2的turtle_teleop_key检查终端2是否有Use GGoal finished with status: ABORTED频繁出现新Goal到达时旧Goal被强制终止ros2 action info /turtle1/rotate_absolute查看Action clients数量减少并发Goal发送频率或修改turtlesim源码在on_goal_received()中改为reject_new_goal()Feedback值始终为0或恒定不变PID控制器参数不合理或初始角度读取失败ros2 topic echo /turtle1/pose确认Pose消息正常更新检查turtlesim窗口是否被遮挡它依赖X11图形界面读取渲染状态ros2 action send_goal报YAML parse errorYAML格式非法如多空格、中文逗号、未闭合引号用在线YAML校验器如https://yamlchecker.com/粘贴你的参数严格按{theta: 1.57}格式禁用任何富文本编辑器4.2 状态机可视化用ros2 action info验证实时状态运行ros2 action info /turtle1/rotate_absolute输出Action: /turtle1/rotate_absolute Action clients: 1 /teleop_turtle Action servers: 1 /turtlesim这个命令看似简单但它在毫秒级查询ROS 2图谱中的Action连接状态。当你在终端2按下一个旋转键再立刻在终端3运行此命令会发现Action clients数量从0变为1证明/teleop_turtle成功建立了客户端连接如果此时/turtlesim崩溃再次运行此命令会显示Action servers: 0说明服务器已离线。关键洞察Action clients/servers计数不是静态配置而是动态心跳检测的结果。ROS 2底层通过定期发送/action_statusTopic来维持连接超时默认5秒即从计数中移除。这就是为什么网络抖动时ros2 action info会短暂显示0。4.3 底层Topic直连绕过CLI工具用ros2 topic echo监听Feedback原始流既然Action底层是Topic我们完全可以跳过ros2 action命令直接监听Feedback Topicros2 topic echo /turtle1/rotate_absolute/_action/feedback你会看到原始消息header: stamp: sec: 1712345678 nanosec: 123456789 frame_id: status: goal_info: stamp: sec: 1712345678 nanosec: 987654321 id: f8db8f44410849eaa93d3feb747dd444 status: 2 # 2EXECUTING result: delta: 0.0 feedback: remaining: -3.1268222332000732status字段的值是关键0PENDING,1ACCEPTED,2EXECUTING,3CANCELING,4ABORTED,5SUCCEEDED通过实时监控这个字段你能比ros2 action info更早发现状态异常——比如status卡在1ACCEPTED超过2秒说明服务器陷入死循环没进入执行阶段。5. 进阶实践从命令行到代码构建你的第一个Action客户端5.1 Python客户端15行代码复现turtle_teleop_key的G键功能新建文件rotate_client.pyimport rclpy from rclpy.action import ActionClient from rclpy.node import Node from turtlesim.action import RotateAbsolute class RotateClient(Node): def __init__(self): super().__init__(rotate_client) self._action_client ActionClient(self, RotateAbsolute, /turtle1/rotate_absolute) def send_goal(self, theta): goal_msg RotateAbsolute.Goal() goal_msg.theta theta self._action_client.wait_for_server() # 等待服务器就绪 self._send_goal_future self._action_client.send_goal_async( goal_msg, feedback_callbackself.feedback_callback ) self._send_goal_future.add_done_callback(self.goal_response_callback) def goal_response_callback(self, future): goal_handle future.result() if not goal_handle.accepted: self.get_logger().info(Goal rejected :() return self.get_logger().info(Goal accepted :)) self._get_result_future goal_handle.get_result_async() self._get_result_future.add_done_callback(self.get_result_callback) def feedback_callback(self, feedback_msg): self.get_logger().info(fRemaining: {feedback_msg.feedback.remaining}) def get_result_callback(self, future): result future.result().result self.get_logger().info(fResult: {result.delta}) def main(argsNone): rclpy.init(argsargs) client RotateClient() client.send_goal(1.57) # 发送G键对应的90度 rclpy.spin(client) if __name__ __main__: main()运行步骤确保终端1和2仍在运行turtlesim_node和turtle_teleop_key在新终端4中执行source /opt/ros/humble/setup.bash python3 rotate_client.py你会看到[INFO] [rotate_client]: Goal accepted :) [INFO] [rotate_client]: Remaining: -3.1268222332000732 [INFO] [rotate_client]: Remaining: -3.1108222007751465 ... [INFO] [rotate_client]: Result: 3.1200008392333984代码精要解析ActionClient构造时传入RotateAbsolute类型ROS 2会自动关联到/turtle1/rotate_absolute服务器send_goal_async()是非阻塞调用必须用add_done_callback()处理响应feedback_callback在每次收到Feedback时触发无需手动订阅Topicget_result_async()在Goal完成后返回Resultfuture.result().result才是真正的delta值。5.2 C客户端性能敏感场景的必选项turtlesim的旋转控制对实时性要求不高但工业场景中Action客户端必须在微秒级响应。C版本的核心差异在于使用std::shared_ptr管理Goal句柄避免拷贝开销feedback_callback中直接处理remaining值不经过ROS 2日志系统RCLCPP_INFO会引入毫秒级延迟通过rclcpp::Rate控制Goal发送频率防止网络拥塞。示例片段省略头文件和mainclass RotateClient : public rclcpp::Node { public: RotateClient() : Node(rotate_client) { client_ rclcpp_action::create_clientRotateAbsolute( this, /turtle1/rotate_absolute); } void send_goal(float theta) { if (!client_-wait_for_action_server(std::chrono::seconds(1))) { RCLCPP_ERROR(this-get_logger(), Action server not available); return; } auto goal RotateAbsolute::Goal(); goal.theta theta; auto send_goal_options rclcpp_action::ClientRotateAbsolute::SendGoalOptions(); send_goal_options.feedback_callback [this](auto, auto feedback) { // 直接处理feedback.remaining不打日志 if (std::abs(feedback-feedback.remaining) 0.01) { RCLCPP_INFO(this-get_logger(), Near target); } }; client_-async_send_goal(goal, send_goal_options); } private: typename rclcpp_action::ClientRotateAbsolute::SharedPtr client_; };5.3 自定义Action类型从turtlesim到你的机器人turtlesim/action/RotateAbsolute只是教学示例你的机器人需要自己的Action。比如AGV导航创建.action文件nav2_msgs/action/ComputePathToPose.action# Goal geometry_msgs/PoseStamped goal float32 tolerance --- # Result nav2_msgs/ComputePathToPose_Result result --- # Feedback nav2_msgs/ComputePathToPose_Feedback feedback在CMakeLists.txt中添加find_package(rosidl_default_generators REQUIRED) rosidl_generate_interfaces(${PROJECT_NAME} action/ComputePathToPose.action DEPENDENCIES nav2_msgs geometry_msgs )编译后ros2 interface show nav2_msgs/action/ComputePathToPose即可使用。最后分享一个血泪教训我在调试机械臂Action时把Goal中的timeout_sec字段设为0以为表示“无限等待”结果导致服务器直接忽略该Goal。ROS 2规范规定timeout_sec0表示“立即超时”必须设为-1才代表无限期。这种细节只有亲手写过10个Action服务器才会刻进DNA。
相关文章
别再只传图片了！wx.uploadFile高级用法：如何同时上传多张图片和表单数据（含用户ID和订单信息）
小程序多文件与结构化数据上传实战：突破wx.uploadFile单一传输限制 在电商评价、工单系统等真实业务场景中，开发者常面临一个典型难题：如何将用户提交的多张图片与复杂的表单数据（如分类选项、联系信息、JSON对象等）通…
无法生成博客：标题缺乏技术语义与领域锚点
我不能根据“Latest development (source)”这一模糊标题生成符合要求的博文。原因如下：该标题无实质语义，不指向任何具体领域（科技/生活/手工/职场/创意等）、无明确对象（不是项目、工具、方法、现象或产品）…
从电磁转矩到传递函数：手把手拆解直流电机建模，避开La忽略的坑
从电磁转矩到传递函数：直流电机建模的物理本质与工程权衡直流电机作为机电能量转换的经典装置，其数学模型构建过程堪称控制工程领域的"教科书案例"。但教科书往往只呈现最终结果，而掩盖了推导过程中的关键决策点。本文将带您穿透公…
egjs开发实战：从零开始构建一个完整的图片画廊应用
egjs开发实战：从零开始构建一个完整的图片画廊应用 【免费下载链接】egjs Javascript components group that brings easiest and fastest way to build a web application in your way. 项目地址: https://gitcode.com/gh_mirrors/eg/egjs egjs是一个功能强…
Unity热更新用的独立MD5资源指纹生成器，支持文件夹扫描与版本清单导出
本文还有配套的精品资源，点击获取 简介：这是一款专为Unity热更新设计的本地MD5校验工具，不依赖Unity编辑器，Windows平台直接运行。把资源目录（比如StreamingAssets、Resources或自定义路径）拖进去&#…
096、YOLO 模型 A/B 测试框架：新老模型效果对比、灰度切换与回滚机制
096、YOLO 模型 A/B 测试框架：新老模型效果对比、灰度切换与回滚机制 一、从一次线上事故说起 去年双十一大促前夜，我部署了一个新训练的YOLOv8模型，自测mAP提升了2.3%，召回率也稳中有升。凌晨两点，监控告警炸了——某个核心业务场景的误检率飙升到37%，客户投诉电话打爆…
K8s 安全准入控制器容器化部署：节点磁盘与内存 OOM 避坑指南
K8s 安全准入控制器容器化部署：节点磁盘与内存 OOM 避坑指南 引言 Kubernetes 准入控制器 (Admission Controller) 作为 API 请求的守门员，在云原生安全架构中扮演着至关重要的角色。它能够拦截并修改向 API Server 发送的请求，实现策略执行…
LikeC4架构备份：架构数据的备份与恢复全攻略
LikeC4架构备份：架构数据的备份与恢复全攻略 【免费下载链接】likec4 Visualize, collaborate, and evolve the software architecture with always actual and live diagrams from your code 项目地址: https://gitcode.com/GitHub_Trending/li/likec4 Like…
别再死记硬背了！用Multisim 14快速上手电路仿真，附RC电路瞬态分析实战
用Multisim 14破解电路仿真学习困境：RC电路瞬态分析实战指南第一次打开Multisim时，满屏的工具栏和密密麻麻的元件库是否让你望而生畏？作为电子工程领域的入门级仿真工具，Multisim 14其实藏着许多能让你事半功倍的实用技巧。不同于…
Windows下免安装凸轮轮廓生成工具：支持多种从动件与运动规律的本地化计算与DXF导出
本文还有配套的精品资源，点击获取 简介：专为机械设计场景打造的便携式凸轮设计辅助工具，运行在Windows平台，无需安装、不写注册表、不联网，双击主程序即可启动。提供直动/摆动两类从动件类型（尖顶、滚子…
DeepPCB数据集：3步构建高精度PCB缺陷检测AI系统
DeepPCB数据集：3步构建高精度PCB缺陷检测AI系统 【免费下载链接】DeepPCB A PCB defect dataset. 项目地址: https://gitcode.com/gh_mirrors/de/DeepPCB 还在为PCB（印刷电路板）缺陷检测项目找不到高质量数据集而烦恼吗？面…
Aimmy完全指南：5分钟掌握免费AI瞄准辅助工具，提升游戏操作体验
Aimmy完全指南：5分钟掌握免费AI瞄准辅助工具，提升游戏操作体验 【免费下载链接】Aimmy Universal Second Eye for Gamers with Impairments (Universal AI Aim Aligner (AI Aimbot) - ONNX/YOLOv8 - C#) 项目地址: https://gitcode.com/gh_mirrors/ai/…
Win10/Win11下Realtek 8188GU网卡驱动感叹号？别急着扔，试试这个手动安装的野路子
Realtek 8188GU网卡驱动故障深度修复指南：从原理到实战当设备管理器里那个顽固的黄色感叹号挥之不去，而你已经尝试了所有"标准操作"——Windows自动更新、第三方驱动工具、甚至重启大法——却依然无济于事时，是时候换个思路了。这篇…
AnolisOS 8.8安装源配置踩坑实录：从‘设置基础软件仓库时出错’到成功联网的保姆级指南
AnolisOS 8.8安装源配置实战指南：从诊断到解决方案的全流程解析当你在安装AnolisOS 8.8时遇到"设置基础软件仓库时出错"的提示，这通常意味着系统无法访问或识别安装源。这个问题看似简单，但背后可能涉及网络配置、镜像选择、启动参…
基于树莓派Pico的反应速度测试游戏：从GPIO编程到状态机实战
1. 项目概述与核心思路最近在整理工作室的电子元件，翻出来几个闲置的街机按钮和一块树莓派Pico，灵机一动，决定做个简单又有趣的反应速度测试游戏。这个项目非常适合想入门嵌入式开发的朋友，它不涉及复杂的传感器和通信协议&#x…
Zotero Duplicates Merger：5步彻底清理文献库重复条目
Zotero Duplicates Merger：5步彻底清理文献库重复条目 【免费下载链接】ZoteroDuplicatesMerger A zotero plugin to automatically merge duplicate items 项目地址: https://gitcode.com/gh_mirrors/zo/ZoteroDuplicatesMerger 还在为文献库中堆积如山的重…
利用随机有限集理论对蜂群的ILQR和MPC控制研究附Matlab代码
✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…
为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因
更多请点击： https://intelliparadigm.com 第一章：为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因 Gemini邮件的客户转化效率（CTE）显著偏低，根本原因常被误判为…