tencent cloud

消息队列 MQTT 版

动态与公告
新功能发布记录
产品简介
TDMQ 产品系列介绍与选型
什么是消息队列 MQTT 版
应用场景
技术架构
产品系列
MQTT 协议兼容说明
开源对比
高可用
产品约束与使用配额
基本概念
开服地域
购买指南
计费概述
续费说明
查看消费明细
欠费说明
退费说明
快速入门
入门流程指引
准备工作
公网接入
VPC 网络接入
用户指南
使用流程指引
配置账号权限
新建集群
管理 Topic
连接集群
查询消息
管理客户端
管理集群
查看监控和配置告警
数据集成
集成数据到云函数 SCF
集成数据到 CKafka
集成数据到 RocketMQ
开发指南
MQTT 5 高级特性
数据面 HTTP 接口说明
配置自定义域名
配置 SQL 过滤
配置点对点订阅
MQTT over QUIC
管理客户端订阅
消息增强规则
实践教程
MQTT 客户端开发注意事项
可观测能力
Topic 与通配符订阅
API 参考
History
Introduction
API Category
Making API Requests
Cluster APIs
Topic APIs
Authorization Policy APIs
User APIs
Client APIs
Message Enhancement Rule APIs
Message APIs
Data Types
Error Codes
SDK 参考
接入点格式
Java SDK
C SDK
Javascript/Node.JS/小程序
Go SDK
iOS SDK
JavaScript SDK
Dart SDK
Python SDK
.NET
安全与合规
权限管理
常见问题
相关协议
隐私协议
数据处理和安全协议
消息队列 MQTT 版服务等级协议
联系我们

MQTT 协议兼容说明

PDF
聚焦模式
字号
最后更新时间: 2026-01-30 15:04:59
本文介绍消息队列 MQTT 版对 MQTT 协议的兼容性情况,以及不同协议版本的功能差异。

协议兼容说明

消息队列 MQTT 版(TDMQ for MQTT,简称 TDMQ MQTT 版)全面兼容了标准的 MQTT 3.1MQTT 3.1.1MQTT 5.0 协议,兼容开源社区 Java、C、C++、Golang、Python、.NET、Rust 等多语言客户端接入。
对于最新的 5.0 协议,除了以下特性暂未兼容外,其余的标准协议内容均已支持:
暂不支持 AUTH Packet:MQTT 5.0 新增的控制报文(Packet Type=0x10),用于实现​​多轮认证协商。但是对于复杂认证场景,TDMQ MQTT 版额外支持了标准协议外的认证方式(如一机一证等),详见认证方式概述
暂不支持指定 Will Delay Interval:CONNECT Packet 中 Will Properties 中的属性之一,用来定义设备异常离线后​​延迟发送遗嘱消息的时间​​(秒)。当前暂未支持,如果客户端传入当前值后,服务端无法识别,默认均为 0。
暂不支持 Server Redirection:服务端在 CONNACK Packet 中返回的备用服务器地址。作为商业化产品,TDMQ MQTT 版会对外提供稳定的SLA保障,在服务端故障时,底层资源会自动切换,客户端的接入点不会改变,因此客户端无需感知备用服务器地址的存在。
对于暂未支持的部分,TDMQ MQTT 将尽快予以支持,您可以关注最新的新功能发布记录

不同协议版本的能力差异

5.0 协议在 3.1.1 协议基础上,主要在以下功能上做了增强。详细差异可以对比 5.0 标准协议参考3.1.1 标准协议参考
报文结构内新增了 Reason Code 字段,提供更多的原因码和详细的错误报告。
扩展的会话管理(即 CONNECT 时的 Clean Start 和Session Expiry Interval 等属性 )。
多种 Packet 内新增属性(User Properties)机制,传递自定义元数据,提供更高的扩展性。
配置共享订阅(Shared Subscriptions):TDMQ MQTT 版在服务端做了功能兼容和增强,除了 5.0 版本的客户端外,同时支持 3.1 和 3.1.1 版本的客户端
主题别名(Topic Aliases)。
流量控制(Receive Maximum)。
增强认证(新增 AUTH Packet)。
服务器断开(Server Disconnect)时可以指示原因和重连地址。
因此,您可以尽快升级客户端 SDK 到 MQTT 5.0 协议版本,享受更多功能。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈