用 github.com/hashicorp/mdns 最省事，但需手动指定网卡、设5秒超时、补全.local；嵌入式/容器/IPv6场景优先选 github.com/grandcat/zeroconf，且必须显式加 zeroconf.IPv6 选项。
直接说结论：用 github.com/hashicorp/mdns 最省事，但必须手动指定网卡接口、设够超时、补全 .local 后缀；若需嵌入式/容器/IPv6 优先选 github.com/grandcat/zeroconf，但得显式加 zeroconf.IPv6 选项。
为什么 mdns.Lookup 总是收不到结果
不是代码写错，而是默认行为在多数真实环境里“不工作”：
-
mdns.Lookup默认只往系统第一个非回环网卡发包，如果你连着 WiFi 和 Docker 网桥，它大概率发到 Docker 接口上 —— 而对方设备根本收不到 - 没指定域名后缀时，它查的是空字符串，但几乎所有标准客户端（
dns-sd -B、avahi-browse）只响应.local - 默认超时是
time.Second * 2，而 mDNS 响应常因网络抖动延迟到 2.5 秒以上，直接返回空 - 某些 macOS/iOS 设备会过滤掉非标准服务类型（比如
_myapp._tcp），只认_http._tcp这类 IANA 注册名
实操建议：显式构造 mdns.QueryParam，填入 Domain: "local."、Timeout: time.Second * 5、Interface: ifi（用 net.InterfaceByName("en0") 拿真实物理网卡）。
zeroconf.Register 注册后别人还是发现不了
常见漏点比想象中多：
立即学习“go语言免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 服务名没带
.local后缀 ——"MyServer._http._tcp"是错的，必须是"MyServer._http._tcp.local"，少一个字符就进不了标准客户端的列表 -
Port设为 0：库不 panic，但注册静默失败，服务压根不会出现在多播流量里 - 运行在仅启用 IPv6 的设备上（比如某些 Docker 容器或新 macOS），却没传
zeroconf.IPv6选项 —— 它默认只绑 IPv4，UDP 包根本发不出去 - 实例被 GC 回收：注册返回的
*zeroconf.Server必须长期持有，不能函数返回就丢掉，否则服务秒下线
示例关键行：srv, _ := zeroconf.Register("MyAPI", "_http._tcp", "local.", 8080, []string{"ver=2.0"}, zeroconf.IPv6)。
如何避免同名服务冲突导致注册失败
zeroconf 默认遇到重名直接报 ErrNameConflict，而 mdns 库干脆没做冲突检测 —— 两者都不自动改名。
- 要让
zeroconf自动重试（如改成"MyAPI (2)."），必须在Register前传zeroconf.WithNameConflictResolution(true) -
mdns没提供类似开关，得自己封装一层：捕获bind: address already in use错误后，改端口或服务名再试 - 更稳妥的做法是用主机名 + 随机后缀生成唯一实例名，比如
fmt.Sprintf("%s-%s._http._tcp.local", hostname, randStr(4))
注意：名称冲突检测依赖多播响应，如果本地防火墙或路由器禁用了 UDP 多播入站，这个机制本身就会失效。
服务起来了，但 dns-sd 或 avahi-browse 就是看不到
先排除底层链路问题：
- 检查 5353 端口是否被占：
lsof -i :5353（macOS/Linux）或netstat -ano | findstr :5353（Windows）；Docker Desktop、Avahi daemon、甚至某些杀软会抢这个端口 - Linux 下 NetworkManager 可能关了 avahi 的多播转发，临时开一下：
sudo systemctl restart avahi-daemon - macOS 上确认“防火墙”设置里没勾选“阻止所有传入连接”，且网络位置是“家庭”或“办公室”，不是“公共”
- Windows 需把网络配置为“专用网络”，否则默认丢弃 mDNS 包
真正容易被忽略的是：mDNS 不是 TCP 那种可靠协议，一次广播失败就真没了。没有日志、没有重传、没有错误反馈 —— 它就安静地消失了。
