单片机无法直接使用Avahi或ESP-IDF的mDNS组件，因其分别依赖完整POSIX栈和ESP32专属框架；跨平台方案是手动构造符合RFC 6762/6763的DNS-SD报文，通过UDP多播至224.0.0.251:5353，并严格遵循小端序、DNS label编码、字段对齐与长度限制。
为什么单片机上不能直接用 Linux 的 avahi 或 esp-idf 的 mdns 组件
因为 avahi 依赖完整的 POSIX 网络栈和动态内存分配，esp-idf 的 mdns_init() 虽然轻量但绑死在 ESP32 平台、依赖 FreeRTOS 和 IDF 框架，没法移植到 STM32 + LwIP 或 nRF52 + Nordic SoftDevice 这类裸机/轻量 RTOS 场景。
真正能跨平台落地的方案，是绕过高层封装，直接构造 DNS-SD 标准的 mDNS 报文（RFC 6762 / RFC 6763），走 UDP 发送到 224.0.0.251:5353，并监听该地址——这只需要底层支持多播 UDP 和基础 DNS 报文解析能力。
- 报文必须用小端序填充（
uint16_t字段如qtype、qclass需htons()） - 域名必须按 DNS label 格式编码（
"mydevice"→\x08mydevice，不是 null-terminated 字符串） - 所有字段长度必须严格对齐，多 1 字节或少 1 字节都会被 macOS/iOS 的 mDNSResponder 直接丢弃
怎么手动构造一个可被发现的 _http._tcp 局域网服务
核心是发一条标准的 DNS-SD PTR/TXT/SRV/A 记录组合报文。实际中，设备只需广播 PTR（告诉别人“我提供 _http._tcp 服务”）+ SRV（告诉别人“我在哪台主机、哪个端口”）+ TXT（附带元数据，比如 path=/status）即可被发现；A 记录由主机会自动通过 ARP 或已知 IP 补全，不必硬编码。
示例关键字段（C++ 结构体片段，假设使用 LwIP）：
立即学习“C++免费学习笔记（深入）”；
struct mdns_header {
uint16_t id; // 0
uint16_t flags; // 0x8400 (standard query response, authoritive)
uint16_t qdcount; // 0
uint16_t ancount; // 3 (PTR + SRV + TXT)
uint16_t nscount; // 0
uint16_t arcount; // 0
};
// 后续紧贴 header 填充：PTR(_http._tcp.local) → SRV(mydevice.local) → TXT(mydevice.local)
-
qtype设为0x0c（PTR）、0x21（SRV）、0x10（TXT） -
qclass统一用0x0001（IN class） - TXT 记录值需以 length-byte 开头，例如
"path=/status"编码为\x0dpath=/status - 整个报文总长建议 ≤ 512 字节（UDP IPv4 限制），超长会被截断且 iOS 完全忽略
如何在裸机/FreeRTOS 上最小化监听 mDNS 查询请求
不需要实现完整 DNS 解析器。绝大多数查询都是问 “有没有 _http._tcp.local 的 PTR？”，你只需匹配 UDP payload 中是否含连续字节：\x04_http\x04_tcp\x05local\x00\x00\x0c\x00\x01（即 label 形式 _http._tcp.local + qtype=PTR + qclass=IN）。
收到匹配包后，立即原样回复你自己的服务记录（上面构造好的那段报文），无需解析源 IP——mDNS 是链路本地多播，所有响应都发往 224.0.0.251，接收方自己按源 IP 过滤。
- 监听 socket 必须启用
IP_MULTICAST_LOOP（否则发给自己收不到，调试极难定位） - 加入多播组前，确保网卡已配置好 IPv4 地址（哪怕只是 link-local
169.254.x.x） - 不要每秒发一次——RFC 要求初始随机延迟（0–250ms），后续退避到 10s 以上，否则网络会吵醒所有设备的 WiFi 模块
常见抓包失败原因和验证方法
用 Wireshark 抓 224.0.0.251 port 5353 看不到你的包？大概率是底层没正确设置多播 TTL 或接口索引。STM32+LwIP 下必须显式调用 ip_set_option(pcb, SOF_MULTICAST_TTL) 并设为 255；Nordic SDK 则需在 sd_ip4_socket_bind() 后调用 sd_ip4_socket_setopt() 设置 IP_MULTICAST_IF。
- macOS 上用
dns-sd -B _http._tcp查看能否列出你的设备名（注意大小写敏感） - 如果只显示名字不显示端口，说明 SRV 记录的
port字段没用htons()转换 - 如果设备名显示为
mydevice.local但点不开，大概率 TXT 记录格式错误（缺 length byte 或 value 含 \0） - 不要依赖 Arduino 的
ESPmDNS库做对比——它默认开启压缩指针，而很多嵌入式实现不处理压缩，导致解析失败
最麻烦的其实是 DNS name compression：一旦你在报文中重复出现 mydevice.local，后续出现应缩写为 0xc0 0x0c（指向第一个出现位置）。错一位就全盘无效，而且 Wireshark 不报错，只静默丢弃。
