# pitfalls 频道文章列表 · 具身开发者社区

> 来源：https://robotics.hellobike.com/pitfalls/

- [2026-10-27] [FastWAM文档checkpoint图像双重归一化致LIBERO评测失败](https://robotics.hellobike.com/pitfalls/2026-10-27-lerobot-5116)：FastWAM文档引用的checkpoint预处理器与模型代码重复归一化图像导致VAE输入异常，需改用配置正确的镜像checkpoint。
- [2026-10-27] [LeRobot大模型VLA部署延迟高及旧工业臂集成路径咨询](https://robotics.hellobike.com/pitfalls/2026-10-27-lerobot-5102)：针对π0级VLA在旧工业臂部署的延迟与集成问题，建议采用Off-board推理配合Real-Time Chunking策略，并通过Robot基类实现安全限幅。
- [2026-10-27] [LeRobot GR00T图像预处理Tensor转NumPy致训练推理效率低](https://robotics.hellobike.com/pitfalls/2026-10-27-lerobot-3000)：GR00T处理器中冗余的Tensor-Numpy转换导致CPU瓶颈，通过保持数据在GPU上处理可显著降低延迟并消除设备间拷贝。
- [2026-10-27] [IsaacLab Newton后端多ContactSensor同body仅末个有数据](https://robotics.hellobike.com/pitfalls/2026-10-27-isaaclab-8648)：Newton后端同名body多传感器仅最后一个输出有效，其余为零。PR #8733修复了传感器注册覆盖导致的数据读取失效问题。
- [2026-10-26] [LeRobot微调lingbot_va_base报错缺失adapter_config.json](https://robotics.hellobike.com/pitfalls/2026-10-26-lerobot-3975)：LeRobot 0.6.1微调lingbot_va_base时误将基座模型识别为PEFT适配器致训练失败，维护者建议验证PR #4144修复。
- [2026-10-26] [IsaacLab Docker启动报错packaging模块缺失致扩展加载失败](https://robotics.hellobike.com/pitfalls/2026-10-26-isaaclab-7732)：IsaacLab 3.0容器因bundled Python包缺失致扩展导入失败，需重置用户数据并独立验证Isaac Sim环境后再挂载IsaacLab。
- [2026-10-26] [Isaac Lab 3.0容器WebRTC推流黑屏：需手动指定Kit流媒体参数](https://robotics.hellobike.com/pitfalls/2026-10-26-isaaclab-7616)：Isaac Lab 3.0-beta2容器WebRTC连接成功但黑屏，因缺失流配置。可通过追加--kit_args参数或升级develop分支解决。
- [2026-10-25] [realsense-ros设置QoS参数报not supported警告](https://robotics.hellobike.com/pitfalls/2026-10-25-realsense-ros-3583)：在rs_launch.py或yaml中配置depth_qos等参数触发白名单警告，需在launch文件param列表中显式声明该参数定义以消除告警。
- [2026-10-25] [MuJoCo Python绑定类型检查报错Parameter assets unfilled](https://robotics.hellobike.com/pitfalls/2026-10-25-mujoco-244)：MuJoCo官方暂不支持类型检查，可通过安装第三方mujoco-stubs包解决IDE静态方法签名误报问题。
- [2026-10-25] [SmolVLA微调后动作幅值坍缩且夹爪开合不足](https://robotics.hellobike.com/pitfalls/2026-10-25-lerobot-5082)：SmolVLA微调后预测动作幅值严重低于真值，建议优先检查推理时是否加载了微调checkpoint专属的归一化统计量与后处理器。
- [2026-10-24] [MuJoCo simulate.exe在AMD GPU下GUI渲染错乱闪烁](https://robotics.hellobike.com/pitfalls/2026-10-24-mujoco-639)：AMD显卡运行MuJoCo simulate.exe时UI渲染异常，basic.exe正常；建议改用basic.exe或Python脚本替代GUI。
- [2026-10-23] [RealSense D435垂直安装后仿真点云位置偏移与深度图倾斜](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-3483)：D435垂直安装致仿真偏差，需核查URDF俯仰角参数，排查重复纹理干扰，并使用On-Chip工具校准。
- [2026-10-23] [Jetson Orin Nano配D455启用IMU报control_transfer return。](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-3465)：JetPack 6下RealSense D455启用IMU报错，系已知兼容性问题，维护者指向librealsense issue中的通用修复方案。
- [2026-10-23] [RealSense D455 rosbag回放图像呈4级灰度但实际数据正常](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-3457)：D455录制的rosbag在RViz中显示为4级灰度，经排查确认为可视化工具渲染问题，原始数据仍为完整8位灰度。
- [2026-10-23] [D435i获取原始畸变图报错wrong profile selection](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-3456)：D435i启动Y16红外流报profile错误，需改用infra_profile参数并仅支持Y16格式获取未校正图像。
- [2026-10-23] [D435i外部触发下Color与Depth无法硬件同步及FPS配置报错](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-3444)：D435i因RGB传感器独立无法直接硬件同步，需匹配Color/Depth FPS并调整外部触发频率至相机FPS的一半以实现Genlock同步。
- [2026-10-23] [realsense2_camera_msgs编译报错找不到ament_cmake配置](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-3054)：ROS2 Humble下编译realsense-ros失败提示缺失ament_cmake，需在执行colcon build前source环境脚本。
- [2026-10-23] [realsense-ros2-beta T265无里程计发布及话题名变更](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-2463)：T265在ros2-beta下不发布odom，需将pose_fps设为200并启用pose_enabled等参数；ROS2版里程计话题更名为/camera/pose/sample。
- [2026-10-23] [ROS2 Foxy下RVIZ2无法显示T265鱼眼图像话题](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-2091)：RVIZ2不显示T265图像但rqt_graph正常，系ROS2可视化兼容问题，参考rviz#511配置可解决。
- [2026-10-23] [T265 ROS启动文件无法设置曝光及帧率报错](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-1839)：T265帧率固定30Hz不可调；曝光参数在launch中设置失败系已知Bug，建议采用延迟重试机制绕过。
- [2026-10-23] [realsense-ros编译报错fatal error: diagnostic_updater.](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-1831)：编译realsense2_camera时因缺少diagnostic_updater头文件报错，需安装对应ROS2发行版的diagnostic-updater包解决。
- [2026-10-23] [realsense-ros回放T265 bag报错Could not find requested。](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-1807)：使用rs_from_file.launch回放T265 bag时因轮式里程计传感器初始化失败报错，需修改源码绕过该检查。
- [2026-10-23] [realsense-ros节点启动即退出且无Topic，LibRealSense版本不匹配](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-1649)：ROS Wrapper启动后进程立即干净退出导致无节点和话题，系运行时LibRealSense版本与编译时不一致，需重新编译Wrapper解决。
- [2026-10-23] [realsense-ros 无法获取 IMU 数据及参数含义不明](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-1648)：在 realsense-ros 中通过启动参数启用陀螺仪与加速度计以发布 IMU 话题，并查阅官方文档理解运动内参含义。
- [2026-10-23] [RealSense T265运行1-2分钟后话题停止发布且无报错](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-1445)：T265在Raspberry Pi 4上运行约1-2分钟后所有ROS话题静默停止，需物理重连USB恢复，确认为底层驱动与EOL问题。
- [2026-10-23] [RealSense rs-tracking-depth启动报failed to set power。](https://robotics.hellobike.com/pitfalls/2026-10-23-realsense-ros-1307)：Jetson AGX运行示例报电源状态错误及配置文件缺失，通过更换SDK版本、使用供电Hub及补全cfg文件解决。
- [2026-10-23] [MuJoCo Managed Viewer保存XML报错No XML model loaded](https://robotics.hellobike.com/pitfalls/2026-10-23-mujoco-2728)：通过MjSpec启动Viewer时保存XML为空，需先将Spec编译并写入文件再加载模型以绕过旧API限制。
- [2026-10-23] [MuJoCo Unity插件HField地形高度非0-1归一化时物理碰撞穿透](https://robotics.hellobike.com/pitfalls/2026-10-23-mujoco-1930)：MuJoCo Unity插件中HField高度数据未归一化至[0,1]导致物理与渲染不一致，通过应用修复分支或更新PR解决。
- [2026-10-23] [Koch leader校准报错Negative values：反向驱动模式homing offset。](https://robotics.hellobike.com/pitfalls/2026-10-23-lerobot-5060)：Koch leader校准时因elbow_flex电机反向驱动导致offset计算错误引发负值报错，PR #5063已修复该符号逻辑。
- [2026-10-23] [IsaacLab NewtonSiteFrameView在模型finalize后误判非碰撞site报。](https://robotics.hellobike.com/pitfalls/2026-10-23-isaaclab-7401)：NewtonSiteFrameView在sim.reset()后将合法非碰撞MJCF site误判为碰撞体致ValueError，已通过PR #7387修复。
- [2026-10-23] [IsaacLab UsdFrameView读取float3 scale时触发TypeError](https://robotics.hellobike.com/pitfalls/2026-10-23-isaaclab-7400)：UsdFrameView因USD类型绑定不支持隐式转换，读取float3/half3 scale时报错，已通过PR #7385修复。
- [2026-10-22] [Piper机械臂缺失官方C++ SDK，社区提供piper_sdk C++移植版](https://robotics.hellobike.com/pitfalls/2026-10-22-pyagxarm-49)：针对Piper无官方C++ SDK问题，社区开发者已发布MIT许可的piper_sdk C++移植版作为ros2_control集成替代方案。
- [2026-10-22] [MuJoCo MJX 3.3.5运行training_apg报错State无pos属性](https://robotics.hellobike.com/pitfalls/2026-10-22-mujoco-2822)：MJX升级致API变更引发AttributeError，需改用mjx_to_brax()转换数据以兼容新版Data类。
- [2026-10-22] [IsaacLab RayCaster 2D LiDAR 穿透网格击中内表面导致点云异常](https://robotics.hellobike.com/pitfalls/2026-10-22-isaaclab-3013)：RayCaster 2D LiDAR 点云穿透物体击中内部三角面，系网格法线或拓扑问题；转换为 SDF Mesh 可部分缓解。
- [2026-10-22] [IsaacLab RayCasterData缺失ray_distances字段的获取方案](https://robotics.hellobike.com/pitfalls/2026-10-22-isaaclab-2946)：针对RayCasterData未直接输出欧氏距离的问题，维护者提供了三种无需修改源码的现有替代计算与获取方法。
- [2026-10-21] [优傲 UR5e / UR10e 运行 ROS 2 Driver 报 External Control program stopped 与反向端口阻断](https://robotics.hellobike.com/pitfalls/ur5e-ur10e-ros2-driver-external-control-stopped)：示教器启动 External Control URCap 后立即停止或报 Connection refused，源于宿主机防火墙阻断 50001-50004 反向通信端口或 RTDE 频率冲突。
- [2026-10-21] [Jetson Orin 多路 RealSense D435i / D405 开启深度流丢帧与 USB 带宽溢出](https://robotics.hellobike.com/pitfalls/realsense-d435i-usb3-bandwidth-frame-drop-jetson)：双手腕 + 头部 3 路 RealSense 相机在 Jetson Orin 上同时拉流报帧超时（Frame didn't arrive within 5000），需扩容 usbfs_memory_mb 并开启硬件同步。
- [2026-10-21] [OpenPI 微调 π0 / π0.5 时 JAX 显存预分配与 PyTorch DataLoader 冲突导致 OOM](https://robotics.hellobike.com/pitfalls/openpi-pi0-bfloat16-jax-oom-finetune)：OpenPI 默认使用 JAX 占用 75%+ GPU 显存，与 LeRobot PyTorch 视频解码进程并发时触发 CUDA OOM；需配置 XLA_PYTHON_CLIENT_MEM_FRACTION 与 FSDP。
- [2026-10-21] [Livox Mid-360 倾斜或倒装在四足/人形机身时 FAST-LIO2 里程计发散飘飞](https://robotics.hellobike.com/pitfalls/livox-mid360-fast-lio2-imu-extrinsic-divergence)：雷达非水平安装时内置 IMU 重力加速度分量与雷达外参未同步旋转，导致 FAST-LIO2 初始化重力对齐失败、点云地图迅速发散。
- [2026-10-21] [URDF 导入 Isaac Sim / Isaac Lab 转 USD 后足端穿透地面与关节自碰撞爆炸](https://robotics.hellobike.com/pitfalls/isaaclab-rsl-rl-usd-collider-tunneling)：URDF 转 MJCF/USD 时常见凸包网格碰撞体未简化、接触偏移（Contact Offset）设置不当及相邻连杆自碰撞未屏蔽导致仿真失真。
- [2026-10-21] [Isaac-GR00T 微调自定义 LeRobot v2 数据集时 modality.json 动作维度与视频解码报错](https://robotics.hellobike.com/pitfalls/isaac-gr00t-lerobot-parquet-action-horizon-mismatch)：GR00T N1.5/N1.6 要求数据集目录下包含严格的 meta/modality.json 切片映射；未对齐关节索引或缺少 decord/av 解码后端会导致训练中断。
- [2026-10-21] [智身钢镚 L2-W Ultra 运行 RoamerX 室内外切换时双激光雷达与 RTK 位姿跳变](https://robotics.hellobike.com/pitfalls/genisom-roamerx-lidar-gnss-tf-drift)：室内外跨场景切换瞬间 GNSS/RTK 协方差突变引发 EKF 位姿跳变；需在 RoamerX 配置中启用退化检测与平滑权重过渡。
- [2026-10-21] [智身钢镚 L1 / L2 从 MATRiX 仿真迁移强化学习策略至真机时关节索引与轮毂电机震颤](https://robotics.hellobike.com/pitfalls/genisom-matrix-sim2real-joint-order)：MATRiX 仿真导出的 ONNX 策略与真机 SDK 关节顺序或 PD 增益量纲不一致会导致起立扭曲或轮足高频抖动。
- [2026-10-21] [星海图 Galaxea R1 / R1 Lite 双臂与头部 ZED 2i 相机手眼标定 TF 时间戳不同步与抓取偏移](https://robotics.hellobike.com/pitfalls/galaxea-r1-zed2i-arm-hand-eye-calib)：轮式双臂底盘移动后机械臂末端抓取偏移 2-4cm，源于 ZED 2i 光学中心坐标系混淆与 ROS 2 TF 树正运动学关节角零位偏差。
- [2026-10-21] [Franka Research 3 运行 1kHz 力控环报 communication_constraints_violation 的实时内核与网卡调优](https://robotics.hellobike.com/pitfalls/franka-fr3-libfranka-communication-constraints-violation)：libfranka 连续多周期收不到 1kHz 控制包会立即锁臂报错；需配置 PREEMPT_RT 内核、禁用 CPU 节能 C-States 并绑定独立千兆网卡中断。
- [2026-10-21] [云深处绝影 Lite3 / X30 强化学习步态策略 Sim2Real 迁移时小腿关节高频抖动](https://robotics.hellobike.com/pitfalls/deep-robotics-lite3-rl-policy-pd-oscillation)：从 Lite3_rl_training 迁移策略至真机时，因执行器延迟未建模及观测角速度噪声放大导致小腿高频震颤的排查与滤波方法。
- [2026-10-21] [松灵 PiPER 机械臂在 Ubuntu 22.04 下 SocketCAN 1Mbps 帧溢出与使能无响应](https://robotics.hellobike.com/pitfalls/agilex-piper-can-socketcan-bitrate-error)：PiPER 6 自由度机械臂高频控制下 gs_usb CAN 模块发送队列溢出（No buffer space available）及主从模式未切换导致电机无法使能的解决方法。
- [2026-10-21] [智元灵犀 X1 / 远征 A2 在非实时内核下 EtherCAT 1kHz 周期抖动触发关节过流保护](https://robotics.hellobike.com/pitfalls/agibot-x1-ethercat-dc-sync-jitter)：Linux 通用内核调度延迟超过 1.5ms 会导致 IgH EtherCAT 主站 DC 分布式时钟失步，引发准直驱关节力矩脉动与报错锁死。
- [2026-10-20] [PI0.5训练保存Checkpoint时终端无报错退出及RAM OOM](https://robotics.hellobike.com/pitfalls/2026-10-20-openpi-827)：PI0.5训练保存检查点时因RAM溢出导致进程静默退出，可通过编写独立脚本定期清理系统缓存或注释掉train state保存代码绕过。
- [2026-10-19] [dashboard_client SIGINT退出延迟10s因29999端口无welcome消息](https://robotics.hellobike.com/pitfalls/2026-10-19-universal-robots-ros2-driver-2012)：当29999端口接受连接但不发送welcome消息时，SIGINT导致dashboard_client退出耗时约10s，需协同修改Driver与URCL解决。
- [2026-10-19] [MJX spatial tendon内部sidesite导致jax.grad返回NaN](https://robotics.hellobike.com/pitfalls/2026-10-19-mujoco-3696)：MJX中spatial tendon的sidesite位于wrap geom内部时梯度为NaN，需对Newton迭代及反三角函数输入增加数值安全钳位与条件替换。
- [2026-10-18] [MoveIt2 Jazzy/Rolling CI失败及Tutorial作业报错修复](https://robotics.hellobike.com/pitfalls/2026-10-18-moveit2-3589)：MoveIt2在ROS2 Jazzy/Rolling下CI失败，维护者确认已修复无效失败作业并更新moveit2_tutorials解决。
- [2026-10-17] [UR20长距离运动过冲：Tool Speed低于MoveIt关节速度致轨迹跳变](https://robotics.hellobike.com/pitfalls/2026-10-17-universal-robots-ros2-driver-1537)：UR20长距离运动过冲且偏离规划轨迹，系示教器Tool Speed安全限制低于MoveIt关节速度所致，需同步两者速度设置。
- [2026-10-17] [OpenVLA 4-bit量化报错.to不支持bitsandbytes模型](https://robotics.hellobike.com/pitfalls/2026-10-17-openvla-287)：因accelerate≥1.2.0与transformers 4.40.1兼容性缺陷导致4-bit加载失败，降级accelerate或修复代码可解。
- [2026-10-17] [OpenVLA-7B INT4量化加载报错.to() not supported for bitsa。](https://robotics.hellobike.com/pitfalls/2026-10-17-openvla-286)：因accelerate版本过高导致INT4量化模型内部调用.to()失败，降级accelerate至0.26.0或限制<1.2.0可解决。
- [2026-10-17] [RoboArena训练配置缺失weight_loader导致模型随机初始化](https://robotics.hellobike.com/pitfalls/2026-10-17-openpi-856)：RoboArena五个配置项未指定PaliGemma权重加载器，导致训练从随机初始化开始；修复方案为显式设置weight_loader。
- [2026-10-17] [convert_libero_data_to_lerobot内存泄漏致OOM，需重置hf_datas。](https://robotics.hellobike.com/pitfalls/2026-10-17-openpi-829)：Libero数据转换脚本因内存表累积导致OOM，通过在save_episode后重置dataset.hf_dataset解决内存泄漏。
- [2026-10-17] [MuJoCo Menagerie H1模型质量惯性过时导致仿真失真](https://robotics.hellobike.com/pitfalls/2026-10-17-mujoco-menagerie-333)：Menagerie中H1模型质量与惯性参数滞后于官方URDF更新，通过同步unitree_ros最新提交修复，总质量由51.44kg更正为59.34kg。
- [2026-10-17] [MuJoCo mj_ray射线穿过网格共享边时漏检返回-1或错误距离](https://robotics.hellobike.com/pitfalls/2026-10-17-mujoco-3698)：MuJoCo 3.6.0中mj_ray因重心坐标严格比较导致共享边漏检，PR#3704引入Watertight边缘函数算法修复该问题。
- [2026-10-16] [Nav2 Collision Monitor拒绝range=inf的Range消息导致避障失效](https://robotics.hellobike.com/pitfalls/2026-10-16-navigation2-6669)：Collision Monitor因校验逻辑不支持INF值而丢弃有效Range消息，需修改validateMsg函数以允许浮点INF。
- [2026-10-15] [Piper机械臂URDF质量惯性参数不准致重力补偿偏差](https://robotics.hellobike.com/pitfalls/2026-10-15-pyagxarm-67)：Piper机械臂原URDF中Link6质量仅7g导致关节阻抗模式重力补偿异常，维护者已提交修正后的动态参数。
- [2026-10-15] [Livox Mid360雷达发布频率低于预期或运行后衰减](https://robotics.hellobike.com/pitfalls/2026-10-15-livox-ros-driver2-206)：Mid360在树莓派5上发布频率仅达设定值75%或运行数分钟后衰减，建议用ros2_pulse排查瓶颈并启用进程内通信。
- [2026-10-14] [Nav2 Route缺少接近节点触发机制，建议用ON_QUERY插件实现](https://robotics.hellobike.com/pitfalls/2026-10-14-navigation2-6647)：针对Nav2 Route缺乏接近节点触发功能的问题，维护者建议使用现有ON_QUERY操作配合L2距离检查作为替代方案。
- [2026-10-13] [MuJoCo Kinova Gen3仿真启动即剧烈振荡爆炸的修复方案](https://robotics.hellobike.com/pitfalls/2026-10-13-mujoco-menagerie-232)：Kinova Gen3在MuJoCo中因关节惯量与PID增益失配导致启动爆炸，通过下调执行器增益、增加关节阻尼及排除自碰撞解决。
- [2026-10-12] [from_pretrained 未回填路径导致归一化为空](https://robotics.hellobike.com/pitfalls/2026-10-12-lerobot-4647)：程序化加载策略时 pretrained_path=None 会跳过归一化统计；手动回填路径或用 dataset_stats 重建处理器可恢复。
- [2026-10-11] [Unitree G1 rl_lab速度策略外部评测0%得分系模型低速死区所致](https://robotics.hellobike.com/pitfalls/2026-10-11-unitree-rl-lab-145)：G1 rl_lab v0策略在外部基准测试中得分为0，经排查确认Isaac-to-MuJoCo映射正确，故障原因为策略本身存在低速指令死区及抗扰动能力不足。
- [2026-10-11] [n_action_steps=50 导致 LIBERO 成功率下降](https://robotics.hellobike.com/pitfalls/2026-10-11-lerobot-4614)：lerobot/smolvla_libero 默认执行完整 50 动作块，评测成功率下降；传入 --policy.n_action_steps=10 可绕过。
- [2026-10-10] [macOS 安装 Unitree SDK2 Python 卡在 cyclonedds](https://robotics.hellobike.com/pitfalls/unitree-sdk2-python-macos-cyclonedds)：解释 macOS 安装失败的原因，以及开发机和机器人局域网 Ubuntu 机器之间的正确分工。
- [2026-10-10] [Nav2 组合启动时 CostCritic 配置错误导致段错误](https://robotics.hellobike.com/pitfalls/2026-10-10-navigation2-6637)：Jazzy 组合启动下 MPPI CostCritic 配置错误会杀死容器；提问者确认 Rolling 中正常。
- [2026-10-09] [nav2_map_server加载大地图OOM：Eigen中间缓冲与GraphicsMagick内存。](https://robotics.hellobike.com/pitfalls/2026-10-09-navigation2-6413)：针对nav2_map_server加载大地图时峰值内存过高导致OOM，通过重构Eigen向量化路径减少中间缓冲已验证有效，并提议增加原生PGM解析绕过GraphicsMagick冗余分配。
- [2026-10-08] [MoveIt2 RViz设置非空Namespace时default_planning_pipelin。](https://robotics.hellobike.com/pitfalls/2026-10-08-moveit2-3865)：RViz MotionPlanning插件拼接参数名缺斜杠导致默认规划管线丢失，需手动修正参数路径或保持Namespace为空。
- [2026-10-02] [ZED ROS2 Wrapper在JetPack 7.2因CUDA版本不匹配无法运行](https://robotics.hellobike.com/pitfalls/2026-10-02-zed-ros2-wrapper-455)：官方镜像不支持JP7.2，通过jetson-containers构建CUDA 13.2基础镜像并源码编译ROS2与SDK解决。
- [2026-10-02] [urscript_interface连接失败时CTRL-C无法终止进程](https://robotics.hellobike.com/pitfalls/2026-10-02-universal-robots-ros2-driver-838)：urscript_interface因IP错误阻塞在重试循环导致信号处理失效，建议将启动逻辑移至独立线程以支持优雅退出。
- [2026-09-30] [Franka Duo JTC性能下降，官方建议改用joint_impedance_controlle。](https://robotics.hellobike.com/pitfalls/2026-09-30-franka-ros2-247)：FR3 Duo使用JTC性能退化，官方推荐改用joint_impedance_controller并提供了对应增益配置参考。
- [2026-09-29] [Unitree RL训练报错RuntimeError: normal expects std >=。](https://robotics.hellobike.com/pitfalls/2026-09-29-unitree-rl-lab-101)：RL训练中因高度扫描观测值含NaN/Inf导致std异常，需在MDP项中添加nan_to_num及clip处理。
- [2026-09-28] [Pi05 LoRA微调LIBERO成功率仅1%及norm_stats不一致排查](https://robotics.hellobike.com/pitfalls/2026-09-28-openpi-711)：针对Pi05模型LoRA微调LIBERO任务成功率极低问题，建议检查评估配置加载的norm_stats文件是否与微调数据split一致。
- [2026-09-28] [MoveIt2返回错误码-27及规划失败被覆盖为99999](https://robotics.hellobike.com/pitfalls/2026-09-28-moveit2-3667)：-27表示目标状态无效；规划特定错误被覆盖为99999系源码缺陷，需应用PR修复以保留原始错误码。
- [2026-09-28] [Libero 仿真中夹爪一直闭合无法抓取怎么办？](https://robotics.hellobike.com/pitfalls/2026-09-28-isaac-gr00t-136)：GR00T 在 Libero 仿真夹爪不工作，需将夹爪动作从训练的 [0,1] 映射到仿真的 [-1,1]。
- [2026-09-26] [OpenVLA夹爪预测误差46%系复现代码动作反转导致](https://robotics.hellobike.com/pitfalls/2026-09-26-openvla-303)：OpenVLA在fractal20220817数据集上夹爪预测偏差大，经查为复现脚本中夹爪动作被额外反转一次所致，修复后误差降至5.22%。
- [2026-09-22] [unitree_mujoco仿真启动报错Joystick open failed](https://robotics.hellobike.com/pitfalls/2026-09-22-unitree-rl-lab-136)：运行unitree_mujoco时报错Joystick open failed，需加载xpad内核模块并确认/dev/input/js*设备节点存在后重启程序。