FastDDS示例中Publisher与Subscriber无法匹配的排查求助

核心排查方向 #

1. 网络基础验证 #

• 确认两台设备处于同一子网，且能互相ping通（同时测试IPv4和IPv6，FastDDS默认优先使用IPv6，若设备禁用IPv6会导致发现失败）
• 检查防火墙状态：临时关闭本地防火墙测试，或添加规则放行FastDDS默认使用的UDP端口范围（7400-7500）及动态分配的临时端口
• 多网卡绑定问题：若设备有多个网卡（有线/无线），FastDDS可能绑定到非通信网卡。可通过环境变量指定网卡，例如export FASTRTPS_DEFAULT_ADDRESS=<你的网卡IP>，或通过配置文件指定绑定地址

2. 发现机制配置检查 #

• 确认默认Simple Discovery Protocol（SDP）未被禁用：若存在自定义fastdds.xml配置文件，可通过export FASTDDDS_DEFAULT_PROFILES_FILE= 临时禁用自定义配置，使用默认配置测试
• 抓包验证SDP广播：用tcpdump udp port 7400 抓取数据包，检查两台设备间是否有SDP广播包传输

3. 主题与QoS一致性校验 #

• 除主题名称外，必须确保QoS配置完全一致：包括可靠性、持久性、历史策略等，任意一项不匹配都会导致无法建立连接。核对两端代码中QoS的设置（教程默认配置一致，需确认未因添加打印误改）
• 验证数据类型一致性：FastDDS会根据IDL生成的数据类型名称和结构做匹配，确保两端使用的HelloWorld IDL生成代码完全相同

4. 进程环境与权限检查 #

• 确认运行进程的用户拥有网络访问权限，部分系统下普通用户无法绑定特定端口
• 检查环境变量：避免设置了错误的FASTRTPS_DEFAULT_PROFILES_FILE，若与ROS2共用环境，需确保ROS_DOMAIN_ID在两台设备上一致（不同domain id会隔离DDS通信）

查看网络中所有发布/订阅主题的方法 #

• 使用FastDDS命令行工具：运行fastdds discovery list，可列出当前网络内所有DDS参与者、主题、发布者和订阅者的详细信息
• 代码添加调试：在发布/订阅代码中添加主题发现回调，打印所有被发现的主题信息
• 抓包分析：用tcpdump或Wireshark过滤DDS协议包，提取主题相关元数据

本地/跨设备运行的配置说明 #

• 同一设备多终端运行：默认无需额外配置，若使用容器环境，需确保终端共享同一网络命名空间
• 同一网络跨设备运行：默认依赖SDP自动发现，无需额外配置，但若排查后SDP仍异常，可尝试切换为Discovery Server模式（需手动配置服务器地址）

内容的提问来源于stack exchange，提问作者Sterling Mcleod