Airtouch接入Homebridge时JSON配置报错，寻求排查解决

DevOps 小满

2026-8-25

排查Homebridge Airtouch插件配置验证失败问题

你的配置存在几个关键问题，以下是具体排查和修复方案：

1. 核心问题：`units`对象缺失必填标识字段

大多数Homebridge Airtouch插件要求每个空调单元配置必须包含unit_id（部分版本可能用id），用于绑定到实际的Airtouch空调设备。你的配置中没有这个字段，这是验证失败的主要原因。

修复后的完整配置示例

将unit_id添加到units数组的对象中（ID值需根据你的实际设备调整，通常可从Airtouch控制面板或API获取）：

{
  "bridge": {
    "name": "Homebridge",
    "username": "XX:XX:XX:XX:XX:XX",
    "port": 51826,
    "pin": "123-45-678"
  },
  "platforms": [
    {
        "platform": "Airtouch",
        "name": "Airtouch",
        "ip_address": "192.168.0.10",
        "ac_include_temps": false,
        "units": [
            {
                "unit_id": 1,
                "manufacturer": "LG",
                "model": "B36AWY-7G6",
                "fan": ["AUTO", "QUIET", "LOW", "MEDIUM"]
            }
        ]
    }
  ]
}

2. 其他排查方向

JSON完整性检查：确保你的config.json是完整的JSON结构，所有内容包裹在顶层{}中（你提供的片段只是platforms部分，需补充完整的bridge配置）。
插件版本更新：执行以下命令更新到最新版插件，避免旧版本的配置兼容问题：
```
npm update -g homebridge-airtouch
```
网络连通性验证：确认Homebridge所在设备能正常访问192.168.0.10，检查防火墙是否拦截了Airtouch的API端口（默认8899）。