Skip to content

无法添加配件(Accessory out of compliance) ​

在「家庭」App 里添加桥接 / 配件时,若弹出下图——中文 无法添加配件,英文 Accessory out of compliance——表示 HomeKit 认为当前配件暴露的 HAP 服务 / 特征不合规(缺必选特征、组合不合法、与规格不符等),因而拒绝添加。

家庭 App:无法添加配件(Accessory out of compliance)

这和「未认证配件 → 仍然添加」、配对卡在连接中 不是同一类问题:这里是 特征合法性校验失败,不是单纯搜不到或认证提示。

原理 ​

桥接器上每台设备都靠 映射文件 描述有哪些 HAP 服务与特征。

  • 不同设备的特征集合不一样(灯、窗帘、空调、净化器、电视等差异大)。
  • 映射漏了必选特征、或套用了不匹配型号的组合,iOS 就会报 out of compliance。
  • 同桥设备越多,越难定位;设备多时要先 拆分,缩小排查面。

交给 AI 初步排查 ​

优先把嫌疑配件的映射原文复制出来,交给 AI 做初步排查(对照 HAP 必选服务 / 特征、format / perms 等)。

  1. 配件列表里点该设备的 网格 / 管理 图标,打开工具栏。
  2. 点 查看映射文件。

配件详情:点「查看映射文件」

  1. 在「配件映射配置」里点 复制。

配件映射配置:点「复制」

  1. 把全文贴给 AI,并说明:出现 无法添加配件(Accessory out of compliance)、设备型号、是否多设备挂在同一桥。

也可先点 更新映射 再配对;仍失败则务必带上复制出的映射做初步排查。

设备较多时:先拆分,优先拆复杂设备 ​

  1. 先拆分:把嫌疑设备挪到单独桥接器(或先少挂几台),分别配对,定位是哪一台触发。
  2. 优先拆复杂品类:空气净化器 / 加湿器、电视 / 机顶盒、多服务空调等;简单灯、开关、窗帘可后拆。
  3. 拆出后仍失败的那台:再 复制映射 → 交给 AI 初步排查。

稳定性要求高时,复杂设备本就建议独立桥接,见 HomeKit 桥接与配件。

注意 ​

  1. 弹窗点「好」只关闭提示,不会自动修好映射。
  2. 摄像头画面转圈等问题见 配对后一直转圈;本专题只针对本弹窗。
  3. 改映射或拆分后,去掉「家庭」里失败残留再重新添加。

相关文档 ​