# SwerveDriveController转向速率无界及故障恢复崩溃问题

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-11-12-franka-ros2-246
> 频道：pitfalls | 更新日期：2026-11-12 | 标签：auto, github-issue, franka_ros2
> 核心摘要：确认转向速率异常仅存于Fork版本，上游v3.6.1已修复参数绑定、状态重置及故障恢复逻辑。

# SwerveDriveController转向速率无界及故障恢复崩溃问题

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[SwerveDriveController: module steering rate is unbounded with respect to the commanded twist](https://github.com/frankarobotics/franka_ros2/issues/246)（GitHub frankaemika/franka_ros2 #246）

**状态**：已解决

## 问题

SwerveDriveController在指令过零或反向时，模块转向角变化率不受限导致全速旋转；同时控制器触发cartesian_motion_generator_velocity_discontinuity后无法恢复且导致ros2_control_node崩溃。经排查确认该现象仅存在于用户修改后的Fork分支，上游源码无法复现。

## 环境

franka_ros2 v3.4.1/v3.5.3, libfranka 0.20.5, ROS 2 Jazzy; TMR移动底盘(tmrv0_2)搭配FR3 Duo; SwerveDriveController作为platform_velocity_controller运行。

## 解决办法

1. 升级franka_ros2至v3.6.1版本，该版本已修复SwerveDriveController多项缺陷
2. 验证cmd_vel_topic和enabled_speed_limits参数是否正确绑定生效
3. 确认limiter_dt已改用period.seconds()计算以保证时间步长准确
4. 检查on_activate()中previous_commands_及里程计状态/时间戳是否被正确重置
5. 测试故障锁存与恢复机制，确保异常恢复时不再导致ros2_control_node崩溃
6. 若使用自定义Fork，需对比上游v3.6.1代码同步上述修复逻辑

讨论原作者：@boilerbots 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub frankaemika/franka_ros2 #246：SwerveDriveController: module steering rate is unbounded with respect to the commanded twist](https://github.com/frankarobotics/franka_ros2/issues/246)