Skip to content

HomeKit 配对一直卡在「连接中」 ​

扫码或点选配件后,「家庭」App 停在连接中、迟迟不往下走。先分清是正常提示慢半拍,还是根本搜不到 / mDNS 异常。

正常时应立刻出现「未认证配件」 ​

Olink 桥接 / 摄像头单配件属于未认证配件。配对流程里,很快就应弹出:

未认证配件:点「仍然添加」继续

点 仍然添加 即可继续;点取消会中断本次配对。

经验规则:若超过约 3 秒仍没有这个弹窗,不要空等——回到 / 打开配件搜索页看设备在不在列表里。

超过 3 秒没弹窗:先看搜索页 ​

搜索页「附近」里应能看到本次要加的配件(名称以控制台里的桥接器 / 单配件名为准),例如:

家庭 App 搜索页:附近应出现待添加配件

搜索页情况怎么理解
能看到设备,但点进去仍久卡连接中、也不出「未认证配件」多半是发现到了、配对握手卡住;可退出重试、确认手机与 Olink 同一局域网,必要时重启 Olink 后再扫
附近列表里根本没有该配件按下面当作 mDNS / 网络发现 问题处理

搜不到设备:按 mDNS 排查 ​

搜不到 = iPhone 没通过局域网发现到 Olink 广播的配件,优先查这些:

  1. 网卡
    运行 Olink 的主机若有多块网卡(有线 + Wi-Fi、Docker bridge、虚拟网卡等),确认 HAP / mDNS 绑在手机所在局域网那块上,而不是只在 docker0 / 错网段。

  2. 重启 Olink
    改完网卡或网络后,重启一次 Olink 服务,让 mDNS 重新广播,再回「家庭」重新添加。

  3. 局域网重名
    附近若已有同名或极易混淆的桥接器 / 配件(多次重置残留、多台 Olink、和其他方案同名),可能导致选错或发现异常。到控制台改成唯一、易辨认的名称后再发现;必要时先移除「家庭」里旧的未用配件。

  4. 同一二层网络
    手机与 Olink 尽量同一网段;避免访客 Wi-Fi、AP 隔离、部分路由器对组播 / mDNS 的限制。

和相近问题的区别 ​

阶段 / 现象文档
还在添加配件,卡在连接中 / 搜不到本文
弹出 无法添加配件(Accessory out of compliance)本弹窗专题
已经配对成功,打开摄像头画面一直转圈配对后一直转圈

仍无法配对时,可用 Mac 抓 homed 日志交给开发者,见 抓取 iOS 日志。

相关文档 ​