本文为您介绍云消息队列 MQTT 版对某些具体指标的约束和规范，以便您在使用云消息队列 MQTT 版时不要超过相应的限制值，以免程序出现异常。具体的限制项和限制值请参见下表。

如果您购买了企业铂金版的云消息队列 MQTT 版，则可按需定制部分指标（下表中已标出），咨询定制请联系云消息队列 MQTT 版技术支持，钉钉群号：35228338。

表 1. 使用限制说明
限制项限制值说明
Topic长度64个字符使用云消息队列 MQTT 版收发消息时，Topic长度不得超过该限制，否则会导致无法发送或者订阅。
Topic跨地域使用无云消息队列 MQTT 版实例的Topic与该实例所绑定的后端消息持久化实例，如云消息队列 RocketMQ 版实例的Topic应处于同一地域。
Topic和Client ID可用字符仅限数字0-9，字母a-z或A-Z，和符号“-”、“_”Client ID和云消息队列 MQTT 版的Topic不允许使用“/”、“:”、“,”、“%”等其他非常规字符，否则可能导致无法连接和收发消息
Client ID长度64个字符使用云消息队列 MQTT 版收发消息时，Client ID长度不得超过该限制，否则会导致连接被断开。
消息大小64 KB消息负载不得超过该限制，否则消息会被丢弃（企业铂金版可定制）。
消息保存时间3天目前仅当使用QoS1持久化Session时才会保留离线消息，且最多保留3天，超过时间将自动滚动删除（企业铂金版可定制）。
用户消息收发TPS参考实例规格
  • 预付费实例会根据购买的规格进行限流，超过规格后将不保证消息可靠到达。
  • 按量付费实例消息TPS不超过5万，否则可能会被系统限流，如有特殊需求，请联系云消息队列 MQTT 版技术支持，钉钉群号：35228338。
  • 在MQTT客户端场景下，单MQTT客户端消息收发量一般不会很大，且某些SDK设计上不支持，建议单MQTT客户端消息TPS不超过20。如您所需的消息收发量较大，且是服务端使用场景，请考虑使用云消息队列 RocketMQ 版客户端。
用户连接数参考实例规格预付费实例会根据购买的规格进行限流，超过规格后将不保证连接稳定性。后付费实例不会限流，但会默认提供监控报警。请合理调整监控阈值。
用户订阅关系数参考实例规格预付费实例会根据购买的规格进行限流，超过规格后将不保证订阅关系完整。后付费实例不会限流，但会默认提供监控报警。请合理调整监控阈值。
单个客户端订阅Topic数量30个使用云消息队列 MQTT 版收发消息时，每个客户端最多允许同时订阅30个Topic，超过该限制会导致无法新增新的订阅关系（企业铂金版可定制）。
QoS和cleanSession目前不支持QoS2的持久Session使用云消息队列 MQTT 版收发消息时，服务端目前不支持QoS2方式的持久化Session订阅。如果需要接收离线消息，请使用QoS1方式的持久化Session订阅。
Token有效期30天调用申请Token接口时，如果ExpireTime的取值大于30天，接口仍然调用成功返回Token，无报错，但实际有效期即为30天。
消息顺序性上行顺序使用云消息队列 MQTT 版收发消息时，目前只保证每个客户端发送消息的顺序性，如果消费消息需要顺序，需要使用云消息队列 RocketMQ 版TCP方式接收消息。
离线消息可见时间10秒服务端首次推送消息后必须要等待超时或者失败后才能确认该消息是否转化为离线消息，对应的延迟时间通常是5秒~10秒。
离线消息存储数量1,000,000条服务端会限制每个实例存储的离线消息数量。超过该限制后，服务端会从最早的消息开始清理。因此，请合理使用持久化订阅模式，以免产生很多无用的离线消息。

如果默认限制不满足，请联系云消息队列 MQTT 版技术支持，钉钉群号：35228338。

通配符订阅关系数量每个父级Topic下仅允许100个通配符订阅关系。服务端会限制每个父级Topic生效的通配符订阅关系的数量，超过限制后服务端会只加载100个，可能会造成部分订阅的客户端收不到消息。请严格控制数量。
云消息队列 MQTT 版域名接入点对应的IP地址无
该IP地址随时可能更换，请勿假设IP地址固定。在以下使用情况中出现的问题云消息队列 MQTT 版产品方概不负责：
  • 客户端不使用域名接入而是使用IP地址接入，产品方更新了域名解析导致原有IP地址失效。
  • 客户端网络对IP地址设置网络防火墙策略，产品方更新了域名解析后新IP地址被您的防火墙策略拦截。