MQTT 连接与消息边界#

MQTT 认证材料来自登录与服务端账号供给链，但该链不能证明当前 Broker 地址、TLS、ACL 或断线恢复已在目标环境生效。App 不应自行生成账号，也不应把 HTTP 权限判断直接套用于 MQTT。

平台 IoT 请求/应答、设备直达命令、单向事件和 Janus Normal/Admin 是不同协议族。topic 模板、契约、方向与消费方的全量事实以 MQTT 清单为唯一权威源（18 静态 topic + 7 谓词族 + 5 动态下行），重点主题的 payload 详解见其链接的详解页，消费者语义见MQTT 消费者全量表；相同 topic 但 action、sub 或消息形态不同仍是不同操作，订阅时机与关联规则由具体操作页叙述。

发布 Promise 完成只表示客户端已完成 Broker 发布调用。QoS 不能推出业务必达、设备已执行或可安全重试。请求/应答的超时、最大回复数、重连、重订阅、取消和资源清理由具体操作页说明。

依据#

适用后端基线：源码归纳 @ 2026-09-14。账号供给（公共/设备账号同步）、网关订阅与协议族路由、请求/应答边界与异步处理边界均为源码归纳结论；订阅面与 QoS 的事实见MQTT 主题清单。