设备常离线问题
米家侧偶发把设备标成离线后,Olink 会把对外可达性也打成不可用,苹果「家庭」里读特征时常见 无响应、配件变灰。若设备其实还能控、只是云端状态抖,可用接入配置里的 一直在线(force_online) 解决。
现象
- 「家庭」里配件显示无响应、不可用,过一会儿又好,反复刷
- Olink / 米家列表里该设备也常跳离线,但本地偶发仍能控制
- BLE(
blt.)、网关 proxy 子设备(proxy.)一般不会误伤(系统已按一直在线处理);本文主要针对普通 Wi-Fi / 网关设备被云端误判离线的情况
这和 配对卡在连接中(根本搜不到配件)不是一类问题;也和摄像头 配对后一直转圈(画面编码)无关。
运行原理(Olink 怎么判「在不在线」)
Olink 对齐小米 Home / ha_xiaomi_home 的思路:每台米家设备维护多路连通性,再合成一个对外的「是否可用」。
云端状态(Cloud) ──┐
本地网关状态(Gateway)─┼── OR 融合 ──→ 聚合可达
局域网探测(LAN) ──┘ │
▼
Device::available()
│
▼
HomeKit 读特征 / 对外「是否无响应」| 步骤 | 含义 |
|---|---|
| 各路独立更新 | 云 MQTT、本地网关 MQTT、LAN UDP 等各自上报 online/offline |
| OR 融合 | 任一路径在线 → 对外在线;三路都离线 → 对外不可用 |
available() | 对外读取用的总开关;HomeKit 不可用时读特征会失败 →「无响应」 |
| 变化才广播 | 聚合结果真变了才发可达性事件,避免刷屏 |
另外还有两条「抬高对外在线」的捷径(见后文解决方案):
- did 以
blt./proxy.开头:系统内置一直在线,且跳过连通性 Hub 更新; - 接入配置
force_online = true:只让available()恒为 true,内部三路仍照常更新。
米家设备如何判断在线 / 离线
小米生态里,设备「在不在线」不是单点结论,而是多通道状态再合并。常见三路:
1. 云端(Cloud)
- 来源:小米云 HTTP 设备列表里的
online,以及云 MQTT 主题(如device/{did}/state/#)推送的online/offline事件。 - 特点:依赖外网与云连接;云抖动、账号会话、弱网时容易误报离线,即使灯其实在局域网里还能控。
- 特殊:
blt.(蓝牙)、proxy.(经网关代理的子设备)云端往往不推上下线事件,生态侧通常假定一直在线,避免误判。
2. 本地网关(Gateway)
- 来源:家里的米家/智造本地网关上的 MQTT(局域网内),反映网关视角下子设备是否在线。
- 特点:不依赖公网云链路也能更新;适合「设备挂在网关下」的场景。网关本身掉线、子设备与网关失联时,这一路会变离线。
- 与云的差异见下一节。
3. 局域网直连(LAN)
- 来源:对可 LAN 的设备做 UDP 探测 / 保活(类似心跳状态机)。
- 特点:最贴近「同一网段能不能摸到设备」;典型逻辑是连续多次探测失败才判离线(量级约十余秒),上线侧往往还有防抖(网络不稳时延迟上线),形成 「离线快、上线慢」,减少狂闪。
- 访客 Wi-Fi、AP 隔离、跨网段时,这一路经常帮不上忙。
融合结果
云 online ∨ 本地网关 online ∨ LAN online → 设备在线
三者皆 offline(或云已移除且另两路也不在) → 设备离线因此:只有云说离线,但本地网关或 LAN 仍在线时,聚合结果仍应是在线。
常离线刷「无响应」的典型情况是:云报离线,同时 LAN / 本地网关也没能及时证明在线(未建 LAN、跨网段、网关未接入等),三路 OR 变成 false。
云端网关 vs 本地网关(差异)
这里的「网关」容易混:一个是云上的状态通道,一个是家里那台本地网关设备。
| 云端(Cloud) | 本地网关(Gateway) | |
|---|---|---|
| 路径 | 经公网到小米云,再 MQTT / 列表下发 | 家里网关在局域网 MQTT,Olink 与网关同网即可 |
| 依赖 | 外网、云服务、账号会话 | 网关在线、子设备与网关射频/链路正常 |
| 延迟与抖动 | 弱网、云波动时易抖 | 一般更稳,但网关重启 / 子设备掉网关会抖 |
| 典型误判 | 「米家 App 偶发离线、家里其实能控」 | 「子设备离网关但 Wi-Fi 灯还在」等网关拓扑问题 |
| 和 LAN 关系 | 与 LAN 独立;云离线不代表局域网 ping 不通 | 子设备往往只经网关出现,不一定有独立 LAN 探测 |
补充:
- 仅走云、没接本地网关、也没有有效 LAN:在线几乎完全听云的 → 云抖就整机抖,HomeKit 最容易刷无响应。
- 云 + 本地网关 / LAN 齐备:云误报离线时,只要网关或 LAN 仍 online,OR 融合仍应对外在线。
- 控制台里「米家网关」相关能力,主要增强的是 Gateway / 本地侧 可见性与订阅,不能消灭云通道本身的抖动,但能在融合里多一条「本地在线」票。
注意事项
force_online不保证能控制成功
只抬高对外「当作在线」;灯真断电、真离线时,读写仍会失败,只是 Home 不一定先显示无响应。不要对所有设备无脑一直在线
若你要用「离线」做通知、自动化(人离开、设备掉线告警),开了force_online后对外看不到离线,告警会失效。先改善网络与网关,再考虑强行在线
优先:手机 / Olink / 设备同网、避免访客 Wi-Fi 隔离、需要时接入本地米家网关、确认 LAN 探测条件。仍被云误伤再对个别设备开force_online。blt./proxy.一般不用再开
系统已按一直在线处理;再写force_online多为重复。保存配置看是否真写上
force_online = true须在有效 TOML 里(不是注释行);保存后热生效,不必重配对。
解决方案:接入配置「一直在线」/ force_online
在该设备的 接入配置 里打开 一直在线(对应 TOML:force_online = true)。
操作步骤
- 打开控制台 设备(或米家设备列表)→ 找到目标设备。
- 点该行的 接入配置。
- 在 表单 页打开 一直在线 开关(也可切到 TOML 写入
force_online = true)。 - 保存。该开关热生效,一般不必重建备、不必重配对。
- 回到「家庭」再试读状态 / 控制;无响应应明显减少或消失。

TOML 等价写法:
force_online = true要恢复真实离线语义:关掉「一直在线」,或删掉 / 改回 force_online = false,或恢复默认后保存。
打开之后会怎样
| 行为 | 说明 |
|---|---|
| 「家庭」对外在线 | 一直当在线,不再因云端误判刷无响应 |
| 云 / 网关 / LAN 内部状态 | 照常更新(订阅、通道切换仍按真实连通性) |
| 设备真离线时控制 | 仍可能失败(不会伪装成读写成功) |
适合: 云端状态不稳、但不希望 HomeKit 频繁无响应。
不适合: 要用真实离线态做自动化、告警的场景——开了之后对外看不到「离线」。
和 blt. / proxy. 的区别
blt. / proxy.(系统内置) | 接入配置 force_online | |
|---|---|---|
| 对外一直在线 | 是 | 是 |
| 连通性 Hub 更新 | 跳过 | 照常 |
| 怎么开 | did 前缀自动 | 手动写 TOML |
仍无响应时再查
- 确认保存成功、配置里确实是
force_online = true(不是只写在注释里)。 - 真离线导致控制失败时,先看米家 App 能否控、Olink 与设备是否同网。
- 若是搜不到配件、卡在连接中,见 配对卡在连接中。