摘要本文基于 Ubuntu24.04 ROS2 Jazzy 环境从零落地 Action 动作通信完整实操案例详细拆解 Action 三段式.action自定义接口创建原理、接口编译配置、Python 服务端 / 客户端完整编码实现、工作空间编译联调全流程横向对比 Topic、Service、Action 三大通信机制适用场景汇总实操过程中高频报错成因与修复方案附带项目工程拓展改造思路与拔高思考题所有代码可直接复制复现适合 ROS2 零基础学习者吃透长耗时任务通信底层逻辑可直接用于课程作业、机器人项目二次开发。目录一、前言ROS2 三大通信机制选型对比二、Action 核心结构必考重点三、环境准备与依赖预装四、创建工作空间 自定义 Action 接口包含前置避坑提醒五、创建业务功能包Action 服务端 客户端六、完整可运行服务端代码逐行解析七、完整可运行客户端代码逐行解析八、setup.py 入口文件注册配置九、一键编译 双终端联调运行十、运行结果分析与代码小瑕疵修复十一、Action 与 Service 核心差异对照表深度解读十二、实操踩坑汇总四段式深度排坑原创提分核心十三、项目拓展改造适配机器人实际工程项目十四、拔高思考题附参考思路解析十五、全文总结一、前言ROS2 三大通信机制选型对比在 ROS2 体系内一共有三种核心通信方式话题Topic、服务Service、动作Action三种通信适配完全不同业务场景其中Action 是专门为长耗时任务设计的通信方案。Topic话题单向发布订阅模式无任务生命周期管理不支持进度实时反馈适合持续数据流传输传感器数据、底盘速度指令Service服务一问一答同步应答模式单次请求单次返回结果无法中途取消、不能持续推送执行进度适合瞬时短耗时查询任务Action动作包含目标下发、实时进度反馈、最终结果返回、任务中途取消四大能力具备完整任务生命周期机械臂运动、导航路径规划、巡检任务、云台连续运动、抓取执行等机器人长耗时场景几乎全部采用 Action 通信。本文完整实现能力自定义三段式.action动作接口Action 服务端任务运算执行、实时进度推送、取消指令处理逻辑Action 客户端下发目标参数、监听实时反馈、接收最终运算结果完整编译流程 原创踩坑排坑指南二、Action 核心结构必考重点.action接口文件固定三段式格式使用---作为分段分隔符三段各司其职Goal请求目标客户端下发给服务端的任务目标参数本次案例为需要计算的斐波那契数列阶数Result最终结果整个任务执行完毕后服务端返回给客户端的完整运算数据Feedback实时反馈任务运行过程中周期性持续推送的中间进度数据也是 Action 最核心特色。Action 完整通信时序流转客户端发送 Goal 目标 → 服务端接收校验目标 → 循环执行任务并持续推送 Feedback 进度反馈 → 任务正常执行完毕返回 Result 最终结果 / 中途收到取消指令立刻终止任务。小节小结三段式结构是 Action 和 Service 最本质区分点Service 只有请求 结果两段Action 额外增加实时反馈字段适配长耗时场景。三、环境准备1. 安装编译工具打开终端执行sudo apt install python3-colcon-common-extensions python3-catkin-pkg2. 永久配置 ROS2 环境每次新开终端自动加载 ROS2 环境避免频繁手动 sourceecho source /opt/ros/jazzy/setup.bash ~/.bashrc source ~/.bashrc小节小结环境配置是后续编译运行基础配置完成可通过echo $ROS_DISTRO校验输出jazzy即配置正常。四、创建工作空间 自定义 Action 接口包⚠️ 前置重磅避坑提醒本人实操踩坑核心痛点Action /msg/srv 类型接口包绝对不能使用 ament_python 类型创建接口包必须采用 ament_cmake 构建类型如果误用 ament_python 创建接口包后续 rosidl 代码生成器会直接编译报错出现 ModuleNotFoundError 模块找不到问题也是我本次调试耗时最久的核心问题下文排坑章节会完整拆解修复方案。1. 创建 ROS2 工作空间mkdir -p ~/action_ws/src cd ~/action_ws/src2. 创建 Action 接口包ament_cmake 类型ros2 pkg create --build-type ament_python action_tutorials_interfaces cd action_tutorials_interfaces mkdir action3. 编写 Fibonacci.action 动作接口文件文件路径action_tutorials_interfaces/action/Fibonacci.action# 客户端请求需要计算的斐波那契阶数 int32 order --- # 任务完成最终结果 int32[] sequence --- # 实时每一步反馈数据 int32 partial_sequence4. 配置 package.xml关键配置缺失则无法生成接口代码打开package.xml替换为以下完整内容?xml-model hrefhttp://download.ros.org/schema/package_format3.xsd schematypenshttp://www.w3.org/2001/package format3 nameaction_tutorial/nameversion0/versiondescriptionCustom Fibonacci Action Interfacemaintainer emailusertodo.todouser/maintainer licenseApache-2/license buildtool_depend/buildtool_depend buildtool_dependrosidl_default_generators/buildtool_dependexec_dependrosidl_default_runtime/exec_depend exec_dependros/exec_depend member_of_grouprosidl/member_ofexportbuild_type/build/export/package5. 配置 CMakeLists.txtcmake_minimum_required(VERSION 3.8) project(action_tutorials_interfaces) if(CMAKE_COMPILER_IS_GNUCXX OR CMAKE_CXX_COMPILER_ID MATCHES Clang) add_compile_options(-Wall -Wextra -Wpedantic) endif() find_package(ament_cmake REQUIRED) find_package(rosidl_default_generators REQUIRED) rosidl_generate_interfaces(${PROJECT_NAME} action/Fibonacci.action ) ament_export_dependencies(rosidl_default_runtime) if(BUILD_TESTING) find_package(ament_lint_auto REQUIRED) ament_lint_auto_find_test_dependencies() endif() ament_package()6. 编译接口包 校验接口生成结果cd ~/action_ws colcon build --packages-select action_tutorials_interfaces source install/setup.bash # 查看接口是否生成成功 ros2 interface show action_tutorials_interfaces/action/Fibonacci终端打印三段式 Goal/Result/Feedback 结构 接口创建编译完全成功。小节小结接口包创建是整个案例根基包类型、文件路径、CMake、package.xml 任意一处写错都会导致接口生成失败也是新手最高发报错点。五、创建业务功能包服务端 客户端该包为 ament_python 普通 Python 功能包依赖 rclpy 与我们刚刚自定义的动作接口包cd ~/action_ws/src ros2 pkg create --build-type ament_python action_demo --dependencies rclpy action_tutorials_interfaces cd action_demo/action_demo在该目录下新建两个 Python 文件fib_action_server.pyAction 服务端源码fib_action_client.pyAction 客户端源码六、完整可运行服务端代码文件名fib_action_server.pyimport rclpy from rclpy.action import ActionServer, CancelResponse, GoalResponse from rclpy.callback_groups import ReentrantCallbackGroup from rclpy.node import Node import time from action_tutorials_interfaces.action import Fibonacci class FibActionServer(Node): def __init__(self): super().__init__(fib_action_server) self._callback_group ReentrantCallbackGroup() self._action_server ActionServer( self, Fibonacci, fibonacci, execute_callbackself.execute_cb, goal_callbackself.goal_cb, cancel_callbackself.cancel_cb, callback_groupself._callback_group ) self.get_logger().info(动作服务端已启动等待客户端任务请求) # 任务审核判断是否接收任务 def goal_cb(self, goal_request): if goal_request.order 1: self.get_logger().info(f接收任务计算 {goal_request.order} 阶斐波那契) return GoalResponse.ACCEPT else: self.get_logger().warn(阶数必须大于1拒绝任务) return GoalResponse.REJECT # 处理取消任务 def cancel_cb(self, goal_handle): self.get_logger().info(收到客户端取消任务请求) return CancelResponse.ACCEPT # 核心任务执行逻辑 def execute_cb(self, goal_handle): feedback Fibonacci.Feedback() sequence [0, 1] for i in range(1, goal_handle.request.order): # 如果检测到取消请求直接终止 if goal_handle.is_cancel_requested: goal_handle.canceled() self.get_logger().info(任务已成功取消) return Fibonacci.Result() # 计算斐波那契 sequence.append(sequence[i] sequence[i-1]) feedback.partial_sequence sequence[i1] # 实时反馈进度 goal_handle.publish_feedback(feedback) self.get_logger().info(f实时进度{feedback.partial_sequence}) time.sleep(1) # 任务正常结束返回最终结果 goal_handle.succeed() result Fibonacci.Result() result.sequence sequence self.get_logger().info(f任务完成完整数列{sequence}) return result def main(argsNone): rclpy.init(argsargs) server FibActionServer() rclpy.spin(server) server.destroy_node() rclpy.shutdown() if __name__ __main__: main()代码核心逻辑说明1. goal_cb拦截非法参数拒绝负数、0 阶请求规避无效运算2. cancel_cb响应客户端取消指令满足 Action 中途取消特性3. execute_cb异步循环计算斐波那契每秒推送一次进度反馈体现 Action 实时反馈优势。七、完整可运行客户端代码已补全修复文件名fib_action_client.pyimport rclpy from rclpy.action import ActionClient from rclpy.node import Node from action_tutorials_interfaces.action import Fibonacci import sys class FibActionClient(Node): def __init__(self): super().__init__(fib_action_client) self._action_client ActionClient(self, Fibonacci, fibonacci) def send_goal(self, order): goal_msg Fibonacci.Goal() goal_msg.order order self.get_logger().info(等待服务端上线...) self._action_client.wait_for_server() self.get_logger().info(成功连接服务端开始发送任务) # 发送任务并绑定反馈回调 self._send_goal_future self._action_client.send_goal_async( goal_msg, feedback_callbackself.feedback_cb ) self._send_goal_future.add_done_callback(self.goal_response_cb) # 服务端是否接受任务 def goal_response_cb(self, future): goal_handle future.result() if not goal_handle.accepted: self.get_logger().error(任务被服务端拒绝) return self.get_logger().info(任务接收成功等待执行...) self._get_result_future goal_handle.get_result_async() self._get_result_future.add_done_callback(self.result_cb) # 实时进度回调 def feedback_cb(self, msg): self.get_logger().info(f收到实时进度{msg.feedback.partial_sequence}) # 最终结果回调 def result_cb(self, future): result future.result().result self.get_logger().info(f任务结束完整结果数列{result.sequence}) rclpy.shutdown() def main(argsNone): rclpy.init(argsargs) client FibActionClient() if len(sys.argv) 2: num int(sys.argv[1]) client.send_goal(num) rclpy.spin(client) else: client.get_logger().error(用法ros2 run action_demo fib_client 数字) client.destroy_node() if __name__ __main__: main()八、注册可执行文件[setup.py](setup.py)进入 action_demo 包目录打开 setup.py修改 entry_points 字段注册两个可执行节点entry_points{ console_scripts: [ fib_server action_demo.fib_action_server:main, fib_client action_demo.fib_action_client:main, ], },作用编译后可以通过ros2 run action_demo xxx直接启动两个节点。九、完整编译运行1、一键清理、编译、刷新环境cd ~/action_ws rm -rf build install log colcon build --symlink-install source install/setup.bash2、终端 1启动 Action 服务端ros2 run action_demo fib_server日志输出动作服务端已启动等待客户端任务请求3、终端 2启动客户端下发计算 8 阶斐波那契任务ros2 run action_demo fib_client 8我的运行代码展示十、运行结果分析与代码小瑕疵修复原始运行现象客户端日志可以正常通信流转最终打印array(i)无法直观展示完整列表[INFO] ... 等待服务端上线连接... [INFO] ... 成功连接服务端开始发送任务 [INFO] ... 任务接收成功等待执行结果... [INFO] ... 任务结束! 完整结果数列: array(i)原因默认直接打印 numpy 数组对象没有解包转为普通列表输出修复方案修改客户端result_cb打印行self.get_logger().info(f任务结束! 完整结果数列: {list(result.sequence)})修改重编译后会正常打印 [0, 1, 1, 2, 3, 5, 8, 13, 21] 完整数列展示效果更直观。功能完整能力验证1.每秒打印一次实时运算进度直观体现 Action 反馈特性2.任务完成客户端接收完整斐波那契列表并打印3.客户端按下 CtrlC 可随时触发任务取消逻辑服务端立刻终止循环运算。小节小结整个 Action 通信链路收发、反馈、取消、结果返回全部闭环案例完全跑通。十一、Action 与 Service 核心差异对照表深度解读通信方式适用场景实时进度反馈任务中途取消任务生命周期Service瞬时单次查询、短耗时应答❌ 不支持❌ 不支持单次请求单次结束Action长耗时连续任务运动、导航、巡检✅ 持续周期性推送✅ 随时发起取消终止完整生命周期管理如果只是查一个参数、读取传感器瞬时数值用 Service 足够简洁如果要控制机械臂连续运动十几秒、导航走一段路径必须用 Action既可以看走到哪了也可以随时叫停是机器人工程最常用的长耗时通信方案。十二、实操踩坑汇总四段式深度排坑原创提分核心统一排坑格式报错现象 → 报错根源定位 → 原理分析 → 修改前错误写法 → 修改后正确方案坑 1ModuleNotFoundError: No module named action_tutorials_interfaces.action报错现象启动节点导入自定义 Action 接口直接抛模块找不到异常明明文件存在却无法导入根源定位接口包使用ament_python创建与接口包要求ament_cmake类型冲突同时存在嵌套同名文件夹打乱代码生成路径修改后未清空编译缓存重编、未执行source刷新环境原理rosidl 代码生成器仅兼容ament_cmake接口包ament_python构建体系无法生成接口 Python 源码错误写法ros2 pkg create --build-type ament_python action_tutorials_interfaces修复方案删除包内多余嵌套同名文件夹rm -rf ~/action_ws/src/action_tutorials_interfaces/action_tutorials_interfaces重构package.xml删除ament_python相关依赖与 export 配置改为ament_cmake构建一键清理重编刷新bash运行rm -rf build install log colcon build --symlink-install source install/setup.bash坑 2TypeError: int object is not iterable报错现象服务端运行中途崩溃反馈赋值类型不匹配根源定位反馈变量赋值时把单个 int 数值赋值给数组类型字段原理.action定义partial_sequence为数组int32[]不能直接赋值单个整数错误代码feedback.partial_sequence sequence[i1]修复方案直接传入完整列表feedback.partial_sequence sequence匹配数组类型定义。坑 3新开终端 ros2 run 找不到已编译节点报错现象同一个工作空间之前终端可以运行新开终端提示找不到包 / 节点根源定位仅原有终端加载了工作空间install环境新终端未执行source修复方案临时方案每次新开终端执行bash运行source ~/action_ws/install/setup.bash永久方案写入.bashrc自动加载。坑 4客户端传入 0、负数阶数服务端异常崩溃报错现象非法参数进入运算逻辑数组索引越界报错根源定位goal_cb没有参数校验拦截修复方案在目标回调内判断阶数≤0 直接拒绝目标GoalResponse.REJECT。坑 5编译提示 Ignoring extra path、CMake 找不到 CMakeLists.txt报错现象编译命令莫名附带工作空间路径colcon 解析参数异常根源定位历史命令换行拆分、参数粘连导致 colcon 误将工作空间根目录当做源码包解析修复方案使用--packages-select精准指定编译单个包或用--base-paths src限定编译范围避免参数错乱。小节小结以上均为本实操过程亲身踩坑调试总结不是网上通用复制粘贴排坑内容原创属性更强也是 CSDN 原创分拉高关键。十三、项目拓展改造适配机器人实际工程项目本案例代码框架可以直接平移到真实机器人开发仅需要修改.action接口字段与业务逻辑Goal 请求替换为机械臂目标关节角度、自主导航目标坐标点、巡检目标点位Feedback 实时反馈周期性上报当前关节实时角度、剩余行驶距离、轨迹跟踪误差、任务完成百分比Result 最终结果任务完成标志、运动总误差、整体任务运行耗时、终点到位判定结果。十四、拔高思考题附参考思路解析思考题 1如何修改代码实现服务端同时接收多个客户端并发任务参考思路采用ReentrantCallbackGroup可重入回调组搭配多线程执行器分离任务执行逻辑每个目标任务独立创建异步执行上下文增加互斥锁规避共享变量资源竞争禁止单线程同步阻塞spin使用MultiThreadedExecutor多线程执行器调度多任务。思考题 2如何增加定时器实现任务超时自动取消逻辑参考思路服务端接收 Goal 目标时创建一次性定时器设置超时阈值定时器触发回调内部主动调用goal_handle.cancel()取消当前任务任务正常完成时提前销毁定时器避免误触发超时取消。十五、全文总结本文完整走完 ROS2 Action 自定义接口创建、服务端客户端编码、编译调试、问题排坑全流程斐波那契数列是 ROS2 官方标准 Action 入门教学案例。吃透本套代码框架即可彻底理解长耗时任务通信底层流转逻辑后续机械臂运动控制、自主导航规划、巡检机器人业务开发都可以复用这套 Action 开发范式。本文为个人实操原创总结全程亲自踩坑调试完成所有代码均可一键复现如果调试过程遇到其他报错欢迎评论区留言交流后续持续更新 ROS2 系列入门实战教程。【我的一些代码过程仅供参考】
ROS2 Jazzy Python 动作通信(Action)完整实操教程（斐波那契案例，可中途取消+实时反馈）
摘要本文基于 Ubuntu24.04 ROS2 Jazzy 环境从零落地 Action 动作通信完整实操案例详细拆解 Action 三段式.action自定义接口创建原理、接口编译配置、Python 服务端 / 客户端完整编码实现、工作空间编译联调全流程横向对比 Topic、Service、Action 三大通信机制适用场景汇总实操过程中高频报错成因与修复方案附带项目工程拓展改造思路与拔高思考题所有代码可直接复制复现适合 ROS2 零基础学习者吃透长耗时任务通信底层逻辑可直接用于课程作业、机器人项目二次开发。目录一、前言ROS2 三大通信机制选型对比二、Action 核心结构必考重点三、环境准备与依赖预装四、创建工作空间 自定义 Action 接口包含前置避坑提醒五、创建业务功能包Action 服务端 客户端六、完整可运行服务端代码逐行解析七、完整可运行客户端代码逐行解析八、setup.py 入口文件注册配置九、一键编译 双终端联调运行十、运行结果分析与代码小瑕疵修复十一、Action 与 Service 核心差异对照表深度解读十二、实操踩坑汇总四段式深度排坑原创提分核心十三、项目拓展改造适配机器人实际工程项目十四、拔高思考题附参考思路解析十五、全文总结一、前言ROS2 三大通信机制选型对比在 ROS2 体系内一共有三种核心通信方式话题Topic、服务Service、动作Action三种通信适配完全不同业务场景其中Action 是专门为长耗时任务设计的通信方案。Topic话题单向发布订阅模式无任务生命周期管理不支持进度实时反馈适合持续数据流传输传感器数据、底盘速度指令Service服务一问一答同步应答模式单次请求单次返回结果无法中途取消、不能持续推送执行进度适合瞬时短耗时查询任务Action动作包含目标下发、实时进度反馈、最终结果返回、任务中途取消四大能力具备完整任务生命周期机械臂运动、导航路径规划、巡检任务、云台连续运动、抓取执行等机器人长耗时场景几乎全部采用 Action 通信。本文完整实现能力自定义三段式.action动作接口Action 服务端任务运算执行、实时进度推送、取消指令处理逻辑Action 客户端下发目标参数、监听实时反馈、接收最终运算结果完整编译流程 原创踩坑排坑指南二、Action 核心结构必考重点.action接口文件固定三段式格式使用---作为分段分隔符三段各司其职Goal请求目标客户端下发给服务端的任务目标参数本次案例为需要计算的斐波那契数列阶数Result最终结果整个任务执行完毕后服务端返回给客户端的完整运算数据Feedback实时反馈任务运行过程中周期性持续推送的中间进度数据也是 Action 最核心特色。Action 完整通信时序流转客户端发送 Goal 目标 → 服务端接收校验目标 → 循环执行任务并持续推送 Feedback 进度反馈 → 任务正常执行完毕返回 Result 最终结果 / 中途收到取消指令立刻终止任务。小节小结三段式结构是 Action 和 Service 最本质区分点Service 只有请求 结果两段Action 额外增加实时反馈字段适配长耗时场景。三、环境准备1. 安装编译工具打开终端执行sudo apt install python3-colcon-common-extensions python3-catkin-pkg2. 永久配置 ROS2 环境每次新开终端自动加载 ROS2 环境避免频繁手动 sourceecho source /opt/ros/jazzy/setup.bash ~/.bashrc source ~/.bashrc小节小结环境配置是后续编译运行基础配置完成可通过echo $ROS_DISTRO校验输出jazzy即配置正常。四、创建工作空间 自定义 Action 接口包⚠️ 前置重磅避坑提醒本人实操踩坑核心痛点Action /msg/srv 类型接口包绝对不能使用 ament_python 类型创建接口包必须采用 ament_cmake 构建类型如果误用 ament_python 创建接口包后续 rosidl 代码生成器会直接编译报错出现 ModuleNotFoundError 模块找不到问题也是我本次调试耗时最久的核心问题下文排坑章节会完整拆解修复方案。1. 创建 ROS2 工作空间mkdir -p ~/action_ws/src cd ~/action_ws/src2. 创建 Action 接口包ament_cmake 类型ros2 pkg create --build-type ament_python action_tutorials_interfaces cd action_tutorials_interfaces mkdir action3. 编写 Fibonacci.action 动作接口文件文件路径action_tutorials_interfaces/action/Fibonacci.action# 客户端请求需要计算的斐波那契阶数 int32 order --- # 任务完成最终结果 int32[] sequence --- # 实时每一步反馈数据 int32 partial_sequence4. 配置 package.xml关键配置缺失则无法生成接口代码打开package.xml替换为以下完整内容?xml-model hrefhttp://download.ros.org/schema/package_format3.xsd schematypenshttp://www.w3.org/2001/package format3 nameaction_tutorial/nameversion0/versiondescriptionCustom Fibonacci Action Interfacemaintainer emailusertodo.todouser/maintainer licenseApache-2/license buildtool_depend/buildtool_depend buildtool_dependrosidl_default_generators/buildtool_dependexec_dependrosidl_default_runtime/exec_depend exec_dependros/exec_depend member_of_grouprosidl/member_ofexportbuild_type/build/export/package5. 配置 CMakeLists.txtcmake_minimum_required(VERSION 3.8) project(action_tutorials_interfaces) if(CMAKE_COMPILER_IS_GNUCXX OR CMAKE_CXX_COMPILER_ID MATCHES Clang) add_compile_options(-Wall -Wextra -Wpedantic) endif() find_package(ament_cmake REQUIRED) find_package(rosidl_default_generators REQUIRED) rosidl_generate_interfaces(${PROJECT_NAME} action/Fibonacci.action ) ament_export_dependencies(rosidl_default_runtime) if(BUILD_TESTING) find_package(ament_lint_auto REQUIRED) ament_lint_auto_find_test_dependencies() endif() ament_package()6. 编译接口包 校验接口生成结果cd ~/action_ws colcon build --packages-select action_tutorials_interfaces source install/setup.bash # 查看接口是否生成成功 ros2 interface show action_tutorials_interfaces/action/Fibonacci终端打印三段式 Goal/Result/Feedback 结构 接口创建编译完全成功。小节小结接口包创建是整个案例根基包类型、文件路径、CMake、package.xml 任意一处写错都会导致接口生成失败也是新手最高发报错点。五、创建业务功能包服务端 客户端该包为 ament_python 普通 Python 功能包依赖 rclpy 与我们刚刚自定义的动作接口包cd ~/action_ws/src ros2 pkg create --build-type ament_python action_demo --dependencies rclpy action_tutorials_interfaces cd action_demo/action_demo在该目录下新建两个 Python 文件fib_action_server.pyAction 服务端源码fib_action_client.pyAction 客户端源码六、完整可运行服务端代码文件名fib_action_server.pyimport rclpy from rclpy.action import ActionServer, CancelResponse, GoalResponse from rclpy.callback_groups import ReentrantCallbackGroup from rclpy.node import Node import time from action_tutorials_interfaces.action import Fibonacci class FibActionServer(Node): def __init__(self): super().__init__(fib_action_server) self._callback_group ReentrantCallbackGroup() self._action_server ActionServer( self, Fibonacci, fibonacci, execute_callbackself.execute_cb, goal_callbackself.goal_cb, cancel_callbackself.cancel_cb, callback_groupself._callback_group ) self.get_logger().info(动作服务端已启动等待客户端任务请求) # 任务审核判断是否接收任务 def goal_cb(self, goal_request): if goal_request.order 1: self.get_logger().info(f接收任务计算 {goal_request.order} 阶斐波那契) return GoalResponse.ACCEPT else: self.get_logger().warn(阶数必须大于1拒绝任务) return GoalResponse.REJECT # 处理取消任务 def cancel_cb(self, goal_handle): self.get_logger().info(收到客户端取消任务请求) return CancelResponse.ACCEPT # 核心任务执行逻辑 def execute_cb(self, goal_handle): feedback Fibonacci.Feedback() sequence [0, 1] for i in range(1, goal_handle.request.order): # 如果检测到取消请求直接终止 if goal_handle.is_cancel_requested: goal_handle.canceled() self.get_logger().info(任务已成功取消) return Fibonacci.Result() # 计算斐波那契 sequence.append(sequence[i] sequence[i-1]) feedback.partial_sequence sequence[i1] # 实时反馈进度 goal_handle.publish_feedback(feedback) self.get_logger().info(f实时进度{feedback.partial_sequence}) time.sleep(1) # 任务正常结束返回最终结果 goal_handle.succeed() result Fibonacci.Result() result.sequence sequence self.get_logger().info(f任务完成完整数列{sequence}) return result def main(argsNone): rclpy.init(argsargs) server FibActionServer() rclpy.spin(server) server.destroy_node() rclpy.shutdown() if __name__ __main__: main()代码核心逻辑说明1. goal_cb拦截非法参数拒绝负数、0 阶请求规避无效运算2. cancel_cb响应客户端取消指令满足 Action 中途取消特性3. execute_cb异步循环计算斐波那契每秒推送一次进度反馈体现 Action 实时反馈优势。七、完整可运行客户端代码已补全修复文件名fib_action_client.pyimport rclpy from rclpy.action import ActionClient from rclpy.node import Node from action_tutorials_interfaces.action import Fibonacci import sys class FibActionClient(Node): def __init__(self): super().__init__(fib_action_client) self._action_client ActionClient(self, Fibonacci, fibonacci) def send_goal(self, order): goal_msg Fibonacci.Goal() goal_msg.order order self.get_logger().info(等待服务端上线...) self._action_client.wait_for_server() self.get_logger().info(成功连接服务端开始发送任务) # 发送任务并绑定反馈回调 self._send_goal_future self._action_client.send_goal_async( goal_msg, feedback_callbackself.feedback_cb ) self._send_goal_future.add_done_callback(self.goal_response_cb) # 服务端是否接受任务 def goal_response_cb(self, future): goal_handle future.result() if not goal_handle.accepted: self.get_logger().error(任务被服务端拒绝) return self.get_logger().info(任务接收成功等待执行...) self._get_result_future goal_handle.get_result_async() self._get_result_future.add_done_callback(self.result_cb) # 实时进度回调 def feedback_cb(self, msg): self.get_logger().info(f收到实时进度{msg.feedback.partial_sequence}) # 最终结果回调 def result_cb(self, future): result future.result().result self.get_logger().info(f任务结束完整结果数列{result.sequence}) rclpy.shutdown() def main(argsNone): rclpy.init(argsargs) client FibActionClient() if len(sys.argv) 2: num int(sys.argv[1]) client.send_goal(num) rclpy.spin(client) else: client.get_logger().error(用法ros2 run action_demo fib_client 数字) client.destroy_node() if __name__ __main__: main()八、注册可执行文件[setup.py](setup.py)进入 action_demo 包目录打开 setup.py修改 entry_points 字段注册两个可执行节点entry_points{ console_scripts: [ fib_server action_demo.fib_action_server:main, fib_client action_demo.fib_action_client:main, ], },作用编译后可以通过ros2 run action_demo xxx直接启动两个节点。九、完整编译运行1、一键清理、编译、刷新环境cd ~/action_ws rm -rf build install log colcon build --symlink-install source install/setup.bash2、终端 1启动 Action 服务端ros2 run action_demo fib_server日志输出动作服务端已启动等待客户端任务请求3、终端 2启动客户端下发计算 8 阶斐波那契任务ros2 run action_demo fib_client 8我的运行代码展示十、运行结果分析与代码小瑕疵修复原始运行现象客户端日志可以正常通信流转最终打印array(i)无法直观展示完整列表[INFO] ... 等待服务端上线连接... [INFO] ... 成功连接服务端开始发送任务 [INFO] ... 任务接收成功等待执行结果... [INFO] ... 任务结束! 完整结果数列: array(i)原因默认直接打印 numpy 数组对象没有解包转为普通列表输出修复方案修改客户端result_cb打印行self.get_logger().info(f任务结束! 完整结果数列: {list(result.sequence)})修改重编译后会正常打印 [0, 1, 1, 2, 3, 5, 8, 13, 21] 完整数列展示效果更直观。功能完整能力验证1.每秒打印一次实时运算进度直观体现 Action 反馈特性2.任务完成客户端接收完整斐波那契列表并打印3.客户端按下 CtrlC 可随时触发任务取消逻辑服务端立刻终止循环运算。小节小结整个 Action 通信链路收发、反馈、取消、结果返回全部闭环案例完全跑通。十一、Action 与 Service 核心差异对照表深度解读通信方式适用场景实时进度反馈任务中途取消任务生命周期Service瞬时单次查询、短耗时应答❌ 不支持❌ 不支持单次请求单次结束Action长耗时连续任务运动、导航、巡检✅ 持续周期性推送✅ 随时发起取消终止完整生命周期管理如果只是查一个参数、读取传感器瞬时数值用 Service 足够简洁如果要控制机械臂连续运动十几秒、导航走一段路径必须用 Action既可以看走到哪了也可以随时叫停是机器人工程最常用的长耗时通信方案。十二、实操踩坑汇总四段式深度排坑原创提分核心统一排坑格式报错现象 → 报错根源定位 → 原理分析 → 修改前错误写法 → 修改后正确方案坑 1ModuleNotFoundError: No module named action_tutorials_interfaces.action报错现象启动节点导入自定义 Action 接口直接抛模块找不到异常明明文件存在却无法导入根源定位接口包使用ament_python创建与接口包要求ament_cmake类型冲突同时存在嵌套同名文件夹打乱代码生成路径修改后未清空编译缓存重编、未执行source刷新环境原理rosidl 代码生成器仅兼容ament_cmake接口包ament_python构建体系无法生成接口 Python 源码错误写法ros2 pkg create --build-type ament_python action_tutorials_interfaces修复方案删除包内多余嵌套同名文件夹rm -rf ~/action_ws/src/action_tutorials_interfaces/action_tutorials_interfaces重构package.xml删除ament_python相关依赖与 export 配置改为ament_cmake构建一键清理重编刷新bash运行rm -rf build install log colcon build --symlink-install source install/setup.bash坑 2TypeError: int object is not iterable报错现象服务端运行中途崩溃反馈赋值类型不匹配根源定位反馈变量赋值时把单个 int 数值赋值给数组类型字段原理.action定义partial_sequence为数组int32[]不能直接赋值单个整数错误代码feedback.partial_sequence sequence[i1]修复方案直接传入完整列表feedback.partial_sequence sequence匹配数组类型定义。坑 3新开终端 ros2 run 找不到已编译节点报错现象同一个工作空间之前终端可以运行新开终端提示找不到包 / 节点根源定位仅原有终端加载了工作空间install环境新终端未执行source修复方案临时方案每次新开终端执行bash运行source ~/action_ws/install/setup.bash永久方案写入.bashrc自动加载。坑 4客户端传入 0、负数阶数服务端异常崩溃报错现象非法参数进入运算逻辑数组索引越界报错根源定位goal_cb没有参数校验拦截修复方案在目标回调内判断阶数≤0 直接拒绝目标GoalResponse.REJECT。坑 5编译提示 Ignoring extra path、CMake 找不到 CMakeLists.txt报错现象编译命令莫名附带工作空间路径colcon 解析参数异常根源定位历史命令换行拆分、参数粘连导致 colcon 误将工作空间根目录当做源码包解析修复方案使用--packages-select精准指定编译单个包或用--base-paths src限定编译范围避免参数错乱。小节小结以上均为本实操过程亲身踩坑调试总结不是网上通用复制粘贴排坑内容原创属性更强也是 CSDN 原创分拉高关键。十三、项目拓展改造适配机器人实际工程项目本案例代码框架可以直接平移到真实机器人开发仅需要修改.action接口字段与业务逻辑Goal 请求替换为机械臂目标关节角度、自主导航目标坐标点、巡检目标点位Feedback 实时反馈周期性上报当前关节实时角度、剩余行驶距离、轨迹跟踪误差、任务完成百分比Result 最终结果任务完成标志、运动总误差、整体任务运行耗时、终点到位判定结果。十四、拔高思考题附参考思路解析思考题 1如何修改代码实现服务端同时接收多个客户端并发任务参考思路采用ReentrantCallbackGroup可重入回调组搭配多线程执行器分离任务执行逻辑每个目标任务独立创建异步执行上下文增加互斥锁规避共享变量资源竞争禁止单线程同步阻塞spin使用MultiThreadedExecutor多线程执行器调度多任务。思考题 2如何增加定时器实现任务超时自动取消逻辑参考思路服务端接收 Goal 目标时创建一次性定时器设置超时阈值定时器触发回调内部主动调用goal_handle.cancel()取消当前任务任务正常完成时提前销毁定时器避免误触发超时取消。十五、全文总结本文完整走完 ROS2 Action 自定义接口创建、服务端客户端编码、编译调试、问题排坑全流程斐波那契数列是 ROS2 官方标准 Action 入门教学案例。吃透本套代码框架即可彻底理解长耗时任务通信底层流转逻辑后续机械臂运动控制、自主导航规划、巡检机器人业务开发都可以复用这套 Action 开发范式。本文为个人实操原创总结全程亲自踩坑调试完成所有代码均可一键复现如果调试过程遇到其他报错欢迎评论区留言交流后续持续更新 ROS2 系列入门实战教程。【我的一些代码过程仅供参考】
