全部产品
Search
文档中心

云消息队列 MQTT 版:功能使用相关问题

更新时间:Mar 04, 2026

本文汇总了云消息队列 MQTT 版功能使用相关的常见问题。

云端订阅消息是否支持设置子级 Topic?

云端订阅消息目前不支持设置子级 Topic,默认会接收父级 Topic 下的所有消息。

如果需要区分子级 Topic,可以在收到消息后,通过 MessageProperties 中的 secondTopic 字段进行判断。

通配符订阅关系数量是否可以增加?

每个父级 Topic 下最多允许 100 个通配符订阅关系,无法通过升配增加,该限制与实例规格无关。

说明:MQTT 的 Topic 通配符订阅关系数量,指的是同一 Topic 下不同通配符表达式的数量。例如 topicA/+ 和 topicA/test/+ 算两个通配符。如果两个客户端同时订阅了 topicA/+,对于 topicA 而言只计为一个通配符数量。

精确 Topic 订阅是否有数量限制?

精确 Topic 订阅目前没有数量限制。

什么情况下会保留订阅关系?

  • 通过设置 CleanSession=false 可保留订阅关系。该设置保存的是 Client ID 的订阅关系,客户端重新连接成功后即可继续消费消息。

  • 如果通过 Unsubscribe 取消了订阅,即使设置了 CleanSession=false,订阅关系也不会被保留。

为什么Topic后会带斜线/?

3.2.0版本实例的Topic末尾会自动添加/,3.3.0版本则不会。目前这两个版本之间不支持转换升级。

通配符订阅的数量限制是什么?

每个父级Topic下最多允许100个通配符订阅模式。

需要注意的是,通配符订阅数量是指Topic下不同通配符模式的数量,而非订阅关系的数量。例如topicA/+和topicA/test/+算作两个通配符模式;如果两个客户端同时订阅了topicA/+,对于topicA只计为一个通配符数量。

服务端只会保存最近的100个通配符订阅模式,超出部分将被自动删除。

共享订阅为什么不支持User Properties?

在使用MQTT 5.0协议的共享订阅功能时,Subscriber收到的消息中User Properties为空,而在非共享订阅模式下可以正常接收。

原因:为了兼容MQTT 3.x协议的共享订阅,底层使用MQTT 3.1.1协议实现,因此不支持User Properties功能,且短期内暂无支持计划。

如何清理Topic的订阅关系?

您可以在Topic上配置订阅关系清理周期来自动清理订阅关系。具体操作,请参见订阅关系清理

注意:如果Topic已被删除,则该Topic下的订阅关系无法自动清理。如需清理已删除Topic的订阅关系,请提交工单处理。

共享订阅是否支持通配符?

共享订阅默认不支持通配符。如需启用通配符支持,请提交工单处理。

MQTT实例是否支持重启?

MQTT实例不支持重启操作。

云端SDK和终端SDK有什么区别?

云端SDK使用AMQP协议,采用集群消费模式;终端SDK使用开源MQTT协议,采用广播消费模式。

为什么从MQTT创建的Connector任务状态显示运行异常?

请确认MQTT实例的创建时间。较早创建的MQTT实例不支持Connector功能,因此任务状态会显示为运行异常。如需使用Connector功能,建议创建新的MQTT实例。

离线消息最多能保留多久?

3天。

仅当QoS=1且cleanSession=false时,云消息队列 MQTT 版才会保留离线消息,最多保留3天,超过时间将自动滚动删除。

铂金版实例可支持定制。如需定制,请联系云消息队列 MQTT 版技术支持,钉钉群号:116015007918。

离线消息什么时候会通知?

服务端检测到客户端上线后,会持续推送离线消息。

keepalive一般设置为多少秒比较好?

90秒,云消息队列 MQTT 版默认值为90秒。

微消息队列MQTT版是否支持遗嘱和保留消息?

暂不支持。

Topic长时间不使用会被自动销毁吗?

不会。

云消息队列 MQTT 版不会自动删除您创建的Topic资源和Group ID,除非您的实例到期被释放,实例下创建的Topic和Group被一起释放。

接入点是否支持设置为IP地址?

不支持。

请务必使用域名接入云消息队列 MQTT 版服务端,不得直接使用域名背后的IP地址直接连接,因为IP地址可能随时变化,会导致连接失败。

云消息队列 MQTT 版支持集群消费模式吗?

终端SDK不支持集群消费模式,云端SDK支持集群消费模式。您可以使用终端SDK发送消息,云端SDK订阅消息。

云端SDK适用于云端业务应用集成场景。更多信息,请参见云端开发概述

云消息队列 MQTT 版是否支持设置其他告警接收人?

监控报警会默认向您的阿里云账号绑定的手机号发送通知,暂不支持修改为其他接收人。

云消息队列 MQTT 版是否支持跨云账号迁移实例?

不支持。