zeroconf库是python中实现zeroconf/mdns的事实标准，纯python、跨平台、持续维护；安装用pip install zeroconf，注意名称区分；windows报错多因绑定问题，macos/linux可能ipv6多播被禁；servicebrowser需保持主线程存活；serviceinfo注册须满足类型、名称、端口三重约束；服务发现慢可关coalesce或调低ttl；跨子网需网络设备支持mdns中继。
zeroconf 在 Python 里用 zeroconf 库最靠谱
Python 官方标准库不带 zeroconf 实现，zeroconf（原 python-zeroconf）是事实标准。它纯 Python 实现、跨平台、支持 IPv4/IPv6 双栈，且持续维护——别碰那些年久失修的 fork 或自制轮子。
安装直接：
pip install zeroconf注意不是
pyzeroconf 或 zeroconf-py，后者要么已废弃，要么是镜像名混淆项。
- Windows 上若报
OSError: [WinError 10049]，大概率是没显式绑定到0.0.0.0或未启用多播接口，不是库本身问题 - macOS 12+ 和某些 Linux 发行版默认禁用 IPv6 多播，
zeroconf会自动降级到 IPv4，但服务发现延迟可能变高 - 不要用
asyncio版本（aiodns那类）混搭——zeroconf当前主线仍是同步 + 线程模型，强行异步封装反而容易丢包
ServiceBrowser 启动后没回调？检查事件循环和线程生命周期
ServiceBrowser 是阻塞式监听器，靠后台线程跑，不是“注册即触发”。常见现象：脚本秒退、add_service 从不被调用、日志里没看到任何服务扫描记录。
根本原因通常是主线程结束太快，后台线程被强制终止。正确做法是保持主线程存活：
立即学习“Python免费学习笔记（深入）”；
最权威的 Python 教程，由 Python 作者 Guido van Rossum 主笔，有少许学院味道。中文电子版由刘鑫、李梦夷、Kernel1983 翻译。 文件内容为中英双语。 作者简介： Guido van Rossum是Python编程语言的创始人，现在就职于Google公司，但在他的大部分时间里他都还在为Python语言的发展而努力。自1989年Guido在ABC与语言的基础上创建了Python语言，目前这门语言不仅得到其他开发社区的认可，比如JPython和IronPython的广泛应用
- 加
input()或time.sleep(30)临时调试（别用while True: pass，CPU 白占） - 生产环境建议用
threading.Event().wait()或集成进你自己的主循环 - 如果用在 Flask/FastAPI 等 Web 框架里，务必确认
ServiceBrowser实例是在应用启动时初始化，且生命周期长于请求周期 - 别在 Jupyter Notebook 里反复
run同一段代码——旧线程没清理干净会导致端口占用或重复回调
ServiceInfo 注册失败：名字、类型、端口三者必须同时合法
ServiceInfo 构造失败常静默吞错，但实际注册时抛 BadTypeInNameException 或根本不出现在其他设备的服务列表里。核心约束就三条：
- 服务类型必须以
._tcp.local.或._udp.local.结尾，比如'_myapp._tcp.local.'—— 少点、多点、写成_tcp都不行 - 服务名不能含下划线（
_），但可以有短横线（-）和数字，例如'my-printer-01'合法，'my_printer'会报错 - 端口必须是整数（
int），传字符串'8080'会静默失败；若设为0，系统自动分配，但后续需从info.port读回真实值 - IP 地址建议显式传
['127.0.0.1']或socket.gethostaddresses()结果，别依赖None自动推导——尤其在 Docker 或多网卡机器上极易出错
服务发现慢或漏服务？关掉 coalesce 和检查 TTL
默认情况下，zeroconf 会对同一服务的多次广播做合并（coalesce），提升效率但可能掩盖更新节奏。如果你改了服务元数据（比如版本号、TXT 记录）却迟迟不被客户端感知，大概率是这个机制在“帮忙”。
解决方法很简单，在创建 Zeroconf 实例时关掉：
zconf = Zeroconf(coalesce=False)
另外，TTL（生存时间）默认是 120 秒，意味着客户端缓存该记录最多两分钟。若你希望变更立刻生效，可在 ServiceInfo 初始化时显式压低：
info = ServiceInfo(..., properties={'version': '2.1'}, ttl=30)
- TTL 最小支持 10 秒，再低会被库自动拉回 10
- 降低 TTL 会增加网络广播流量，局域网设备多时慎用
- Android/iOS 原生 mDNS 客户端对 TTL 敏感度不一，iOS 通常更守规矩，Android 常缓存更久——别全指望 TTL 精确控制
真正麻烦的是跨子网场景：mDNS 默认不路由，交换机不开 IGMP Snooping 或不配 mDNS Repeater，设备再怎么调参数也互相看不见。这时候不是代码问题，是网络基建没跟上。
