HomeKit 配对一直卡在「连接中」
扫码或点选配件后,「家庭」App 停在连接中、迟迟不往下走。先分清是正常提示慢半拍,还是根本搜不到 / mDNS 异常。
正常时应立刻出现「未认证配件」
Olink 桥接 / 摄像头单配件属于未认证配件。配对流程里,很快就应弹出:

点 仍然添加 即可继续;点取消会中断本次配对。
经验规则:若超过约 3 秒仍没有这个弹窗,不要空等——回到 / 打开配件搜索页看设备在不在列表里。
超过 3 秒没弹窗:先看搜索页
搜索页「附近」里应能看到本次要加的配件(名称以控制台里的桥接器 / 单配件名为准),例如:

| 搜索页情况 | 怎么理解 |
|---|---|
| 能看到设备,但点进去仍久卡连接中、也不出「未认证配件」 | 多半是发现到了、配对握手卡住;可退出重试、确认手机与 Olink 同一局域网,必要时重启 Olink 后再扫 |
| 附近列表里根本没有该配件 | 按下面当作 mDNS / 网络发现 问题处理 |
搜不到设备:按 mDNS 排查
搜不到 = iPhone 没通过局域网发现到 Olink 广播的配件,优先查这些:
网卡
运行 Olink 的主机若有多块网卡(有线 + Wi-Fi、Docker bridge、虚拟网卡等),确认 HAP / mDNS 绑在手机所在局域网那块上,而不是只在 docker0 / 错网段。重启 Olink
改完网卡或网络后,重启一次 Olink 服务,让 mDNS 重新广播,再回「家庭」重新添加。局域网重名
附近若已有同名或极易混淆的桥接器 / 配件(多次重置残留、多台 Olink、和其他方案同名),可能导致选错或发现异常。到控制台改成唯一、易辨认的名称后再发现;必要时先移除「家庭」里旧的未用配件。同一二层网络
手机与 Olink 尽量同一网段;避免访客 Wi-Fi、AP 隔离、部分路由器对组播 / mDNS 的限制。
和相近问题的区别
| 阶段 / 现象 | 文档 |
|---|---|
| 还在添加配件,卡在连接中 / 搜不到 | 本文 |
| 弹出 无法添加配件(Accessory out of compliance) | 本弹窗专题 |
| 已经配对成功,打开摄像头画面一直转圈 | 配对后一直转圈 |
仍无法配对时,可用 Mac 抓 homed 日志交给开发者,见 抓取 iOS 日志。
相关文档
- 抓取 iOS 日志 —
idevicesyslog -p homed - HomeKit 桥接与配件 — 扫码配对入口
- HomeKit 摄像头接入
- 常见问题总览