最稳方案是用 zeroconf：纯 python、支持 py3.7–3.12、跨平台、无需编译；注意 linux 多播禁用和 windows 防火墙拦截，服务发现需显式指定类型并调 get_service_info() 解析。
Python 里用 zeroconf 做 Bonjour 设备发现最稳
直接说结论：别碰 pybonjour（已十年没维护，Py3.8+ 编译报错），也别自己封装 dns-sd 命令行——zeroconf 是当前唯一靠谱、纯 Python、支持 Py3.7–3.12 的 Bonjour/mDNS 实现。
它底层用系统 socket 监听 5353/udp，不依赖本地 avahi-daemon 或 macOS mdnsresponder，跨平台行为一致。但要注意：Linux 默认可能禁用多播，Windows 防火墙常拦截，这是 80% 的“搜不到设备”问题根源。
- 安装只用
pip install zeroconf，不用编译，无 C 依赖 - 服务发现必须显式指定
ServiceBrowser类型，比如_http._tcp.local.，不能只写_http - 回调函数里拿到的
service_name是完整名（如MyPrinter._ipp._tcp.local.），解析前得先调Zeroconf.get_service_info() - 别在主线程直接
time.sleep(10)等结果——ServiceBrowser是异步的，要用threading.Event().wait()或asyncio配合AsyncZeroconf
ServiceInfo 解析失败常见原因
拿到服务名后调 zeroconf.get_service_info() 返回 None，不是代码写错了，大概率是网络层没通：
- 目标设备没真正注册 mDNS 服务（用 macOS 的
dns-sd -B _http._tcp或 Linux 的avahi-browse -at先确认能被系统原生命令看到） - Python 进程没权限发多播包（Linux 上检查
net.ipv4.ip_forward和net.ipv4.conf.all.send_redirects是否为 0；Docker 容器需加--network=host） - 服务刚上线，但
get_service_info()调太早（mDNS 响应有毫秒级延迟），加个time.sleep(0.2)再查 - 传参时类型写错：
get_service_info(type, name)的type必须带结尾点（_http._tcp.local.），name也必须带结尾点（MyPrinter._http._tcp.local.）
如何避免服务监听卡死或漏事件
ServiceBrowser 启动后不退出，靠回调驱动，但默认行为容易掉事件：
小邮包 包月订购包年程序
下载
小邮包-包月订购包年服务网，该程序由好买卖商城开发，程序采用PHP+MYSQL架设，程序商业模式为目前最为火爆的包月订制包年服务模式，这种包年订购在国外网站已经热火很多年了，并且已经发展到一定规模，像英国的男士用品网站BlackSocks，一年的袜子购买量更是达到了1000万双。功能：1、实现多产品上线，2、不用注册也可以直接下单购买，3、集成目前主流支付接口，4、下单发货均有邮件提醒。
立即学习“Python免费学习笔记（深入）”；
- 回调函数里别做耗时操作（比如同步 HTTP 请求），否则会阻塞整个零配置事件循环——改用
threading.Thread或asyncio.to_thread()拆出去 - 设备下线事件（
remove_service）默认不触发，除非你在构造ServiceBrowser时传handlers=[MyHandler]并实现remove_service方法 - 同一台机器跑多个 Python 进程监听相同服务类型？会互相干扰。每个进程必须用独立的
Zeroconf实例，且监听端口不能冲突（可指定addr="0.0.0.0"+port=0让系统自动分配） - Windows 上如果用 WSL2，宿主机和子系统网络隔离，
zeroconf在 WSL2 里搜不到 Windows 本机广播的服务——要么全切到宿主机跑，要么启用 WSL2 的 UDP 多播转发（需 Win11 22H2+）
生产环境必须关掉的调试开关
开发时开 logging.getLogger("zeroconf").setLevel(logging.DEBUG) 很方便，但上线必须关：
- DEBUG 日志会把每条 mDNS 包的原始 DNS 报文全打出来，IO 开销大，还可能泄露设备名/IP
- 更隐蔽的问题：某些嵌入式设备（如 ESP32 的 Arduino mDNS 库）对高频查询敏感，DEBUG 模式下
zeroconf会主动发 probe 查询，可能触发设备限流甚至断连 - 关闭方式不是删日志行，而是显式设为
WARNING：logging.getLogger("zeroconf").setLevel(logging.WARNING) - 如果你用
python -m zeroconf命令行工具调试，记得它默认是 DEBUG 级，别误当生产脚本用
真要查线上 mDNS 通不通，用 tcpdump -i any port 5353 看原始包比看 Python 日志更准——毕竟 zeroconf 只是用户态解析器，链路层丢包它根本不知道。
