跨设备跑 ROS 2,最折磨的不是装环境,是「话题看得见、数据过不来」。
这次的终点报错只有一行:
ddsi_udp_conn_write to udp/192.168.2.100:7410 failed with retcode -3。
它反复刷屏、不给任何解释,但拆开看其实是一张完整的排查清单。
01这行报错到底在说什么
把句子拆开读:X2(192.168.2.101)已经把 DDS 包发出去了, 目标是 PC 的 7410 端口(DDS discovery 端口),但没有任何应答回来。 所以问题不在发送端,而在对端——三选一:
- 对端没在监听:容器没起、ROS 没跑、进程挂了;
- 网络没通:包到得了网线,到不了进程——bridge 网络隔离、防火墙;
- 配置没对齐:两端的 RMW 实现或 CycloneDDS 配置不一致。
记一个反向结论:
retcode -3说明发送端的 DDS 已经正常运行、 配置已经生效(它按你的 Peers 老老实实去连了)。 排查方向永远在对端,别在发送端反复改配置。
02前提账本:两端四件套必须一致
在查任何网络问题之前,先对一遍两端的四件套——任何一个不一致, 后面的排查全是白费:
echo $ROS_DISTRO # 期望两端相同,如 jazzy
echo $RMW_IMPLEMENTATION # 期望 rmw_cyclonedds_cpp
echo $CYCLONEDDS_URI # 期望指向各自的 xml,且 xml 内容对齐
echo $ROS_DOMAIN_ID # 必须相同
其中 ROS_DISTRO 这一条有过血的教训:PC 上是另一个 ROS 2 发行版时,
底层的类型哈希(Type Hash)和发现机制不一致——
ros2 topic list 偶尔能看到对方的话题,但 echo 永远收不到数据。
这是 ROS 2 官方不支持跨发行版通信的行为,不是配置能绕过的。
最终解法是在 PC 上用 Docker 跑一个和设备完全相同的 Jazzy 容器,
直接抹平版本鸿沟,而不是在跨版本上死磕。
03网络模式:bridge 之下,宿主 IP 到不了进程
这是 retcode -3 最常见的根因。容器默认 bridge 网络时,
容器有自己的 netns:192.168.2.100 是 宿主机网卡的 IP,
不是容器内进程绑定的 IP。包到达宿主机网卡后就止步了——没人转发进容器。
# 在容器里执行。看到 172.17.x.x → 是 bridge,出问题就在这 $ ip addr # 解法:重建容器时加 --network host,共享宿主机网络栈 docker run -it --name ros2_jazzy_pc --network host ... <镜像> bash
为什么不用 -p 逐个映射端口?DDS 除了固定的 7410 发现端口,
每个进程还会动态占用 7410~7472 及之后的端口段,映射清单根本列不全。
DDS 场景下 --network host 是唯一省心的选择。
同理,X2 端的容器当初也是重建时补上了 --network host 才通了绑定。
04CycloneDDS XML:关闭多播,写死单播对等体
多网卡 + 虚拟网络的环境里,DDS 的自动发现(靠 UDP 多播)经常静默失败。 解法是两端各放一份配置,把「选网卡」和「找对端」全部改成显式:
<?xml version="1.0" encoding="UTF-8" ?>
<CycloneDDS xmlns="https://cdds.io/config">
<Domain id="any">
<General>
<Interfaces>
<NetworkInterface name="eth0" />
<NetworkInterface name="lo" />
</Interfaces>
<AllowMulticast>false</AllowMulticast>
</General>
<Discovery>
<Peers>
<Peer address="127.0.0.1"/>
<Peer address="192.168.2.100"/> <!-- 自己 -->
<Peer address="192.168.2.101"/> <!-- 对端 -->
</Peers>
</Discovery>
</Domain>
</CycloneDDS>
四个要点:
- Peers 里要同时写自己和对端,漏写自己的 IP 曾导致
does not match an available interface的绑定报错; - NetworkInterface 加 lo,本机进程间的通信才不会被踢出白名单;
- AllowMulticast 设 false,强制走单播,绕开 WiFi/虚拟交换机吞多播的问题;
- 两端各写一份,对端的 Peers 互相指向对方,网名(eth0/ens33)按各自实际网卡名改。
生效方式是环境变量:
export CYCLONEDDS_URI=file:///root/cyclonedds_direct.xml,
两端都写进各自的 ~/.bashrc。
05防火墙:DDS 端口段要整段放行
sudo ufw allow 7410:7472/udp # ufw sudo firewall-cmd --add-port=7410-7472/udp --permanent # firewalld
如果是 WSL2 里跑 Docker,Windows Defender 防火墙还要单独给 WSL 放行 UDP 入站。
防火墙这一层的特征是:topic list 能看到对方(发现包偶然通了),
但数据流时断时续或完全不通——所以别等它出问题,装环境时顺手放行。
06收尾:一张顺序表 + 最终验证
| 顺序 | 检查项 | 通过标准 |
|---|---|---|
| 1 | 对端容器在跑,四件套一致 | echo 四个变量逐行相同 |
| 2 | 两端 ROS 发行版相同 | $ROS_DISTRO 相同(Jazzy ↔ Jazzy) |
| 3 | 容器网络模式 | 容器内 ip addr 看到宿主物理网卡 IP,无 172.17.x.x |
| 4 | CycloneDDS XML | 两端各一份,Peers 含自己 + 对端,AllowMulticast=false |
| 5 | 防火墙 | UDP 7410-7472 双向放行 |
ros2 topic list # 应看到对端发布的话题
ros2 topic hz /robot/scan # 应稳定输出频率
ros2 topic echo /robot/scan --once
打通之后的两端架构:PC 侧 Docker 容器(Jazzy + host 网络)经直连网线 连 X2 侧 Podman 容器(同样 Jazzy + host 网络),CycloneDDS 纯单播点对点。 之后每次复现,只需要三步:起容器 → source 环境 → talker/listener。
- 关于本文
- 整理自 2026 年 10 月打通「PC(Ubuntu + Docker)↔ 黑豹 X2(Armbian + Podman)」 ROS 2 Jazzy 链路的完整过程。IP、网卡名请按自己的拓扑替换。
- 2026.10.10 整理
- 整个排查走了两次方向转折:先放弃跨发行版(统一成 Jazzy), 再放弃自动发现(CycloneDDS + 显式单播)。 复盘下来,DDS 排障的核心心法是「报错在发送端,问题在对端」—— 顺着这个方向按表排查,半小时能走完当初几天的路。
留言
正在载入留言…