MQTT

• 持久性会话到期时间已过。当消息代理检测到客户端已断开连接（通过客户端断开连接或连接超时）时，持久性会话到期计时器将启动。

• 客户端发送将 cleanSession 标记设置为 1 的 CONNECT 消息。

• 如果当前会话的会话过期间隔为 0，则无法在 DISCONNECT 数据包上将会话过期间隔设置为大于 0。

• 如果当前会话的会话过期间隔大于 0，并且您在 DISCONNECT 数据包上将会话过期间隔设置为 0，会话将在 DISCONNECT 上结束。

• 否则，DISCONNECT 数据包的会话过期间隔将更新当前会话的会话过期间隔。

使用 MQTT 保留消息的示例

• 作为初始配置消息

  客户端订阅主题后，MQTT 保留消息会被发送给客户端。如果您希望所有订阅主题的客户端在订阅后立即收到 MQTT 保留的消息，则可以发布设置了 RETAIN 标志的配置消息。只要发布新的配置消息，订阅客户端也会收到该配置更新。

• 作为最后一个已知的状态消息

  设备可以在当前状态消息上设置 REATIN 标志，以便 Amazon IoT Core 保存它们。当应用程序连接或重新连接时，它们可以订阅此主题，并在订阅保留的消息主题后立即获得上次报告的状态。这样，它们就不必等到设备发出下一条消息才能看到当前状态。

• 创建保留消息

  客户端在发布 MQTT 消息时确定是否保留消息。客户端可以在发布消息时使用 设备 SDK 设置 RETAIN 标志。应用程序和服务可以在使用 Publish 操作 发布 MQTT 消息时设置 RETAIN 标志。

  每个主题名称只保留一条消息。发布到主题的带有 RETAIN 标志设置的新消息将替换先前发送到该主题的任何现有保留消息。

  注意： 如果您设置了 RETAIN 标志则不能发布到 预留主题。

• 订阅保留消息主题

  客户端订阅保留消息主题，就像订阅任何其他 MQTT 消息主题一样。通过订阅保留消息主题接收的保留消息均有 RETAIN 标志设置。

  Amazon IoT Core 当客户端向保留的消息主题发布带有 0 字节消息负载的保留消息时，将删除保留的消息。已订阅保留消息主题的客户端也将收到该 0 字节消息。

  订阅包含保留消息主题的通配符主题筛选条件可使客户端接收发布到保留消息主题的后续消息，但在订阅时不会传递保留消息。

  注意： 要在订阅时接收保留消息，订阅请求中的主题筛选条件必须与保留消息主题完全匹配。

  订阅保留消息主题时收到的保留消息有 RETAIN 标志设置。订阅客户端在订阅后收到的保留消息则没有。

• 检索保留消息

  当客户端使用保留消息订阅主题时，保留消息会被自动发送给客户端。要让客户端在订阅时收到保留消息，必须订阅保留消息的确切主题名称。通过订阅包含保留消息主题的通配符主题筛选条件，客户端可以接收发布到保留消息主题的后续消息，但不会在订阅时传送保留消息。

  服务和应用可以通过调用 ListRetainedMessages 和 GetRetainedMessage 列出和检索保留消息。

  在 未 设置 RETAIN 标志的情况下，客户端不会被阻止发布消息到保留消息主题。这可能会导致意外结果，例如保留消息与订阅主题收到的消息不匹配。

  在 MQTT 5 中，如果保留消息设置了消息过期间隔且保留消息已过期，则订阅该主题的新订阅者在成功订阅后将不会收到该保留消息。

• 列出保留消息主题

  您可以通过调用 ListRetainedMessages 列出保留消息，并且可以在 Amazon IoT 控制台 中查看保留消息。

• 获取保留消息详细信息

  您可以通过调用 GetRetainedMessage 获取保留消息的详细信息，并且可以在 Amazon IoT 控制台 中查看这些信息。

• 保留 Will 消息

  连接设备时创建的 MQTT Will 消息 可以通过设置 Connect Flag bits 字段中的 Will Retain 标记保留。

• 删除保留消息

  通过将设置了 RETAIN 标志的消息和空（0字节）消息负载发布到要删除的保留消息的主题名称，设备、应用程序和服务可以删除保留消息。此类消息会从中删除保留的消息 Amazon IoT Core，发送给订阅了该主题的客户端，但它们不会被保留 Amazon IoT Core。

  还可以通过访问 Amazon IoT 控制台 中的保留消息以交互的方式删除保留消息。通过 Amazon IoT 控制台 删除的保留消息也会向已订阅保留消息主题的客户端发送 0 字节的消息。

  保留消息在删除后无法恢复。客户端需要发布新的保留消息才能取代已删除的消息。

• 保留消息的调试和故障排查

  Amazon IoT 控制台 提供多个工具来帮助您进行保留消息故障排查：

  • 保留消息 页面

    Amazon IoT 控制台中的 保留消息 页面提供您的账户在当前区域中存储的保留消息的分页列表。在此页面上，您可以：

    • 查看每条保留消息的详细信息，例如消息负载、QoS、接收时间。

    • 更新保留消息的内容。

    • 删除保留消息。

  • 打开 MQTT 测试客户端

    Amazon IoT 控制台中的 MQTT 测试客户端 页面可以订阅并发布到 MQTT 主题。发布选项让您可以在发布的消息上设置 REATEIN 标志，以模拟设备的行为方式。

  一些意想不到的结果可能是这些方面实现保留消息的结果 Amazon IoT Core。

  • 保留消息限制

    当一个账户存储了最大数量的保留消息时，会对设置了 RETAIN 且有效负载大于 0 字节的消息 Amazon IoT Core 返回限制响应，直到某些保留的消息被删除并且保留的消息数量降至限制以下。

  • 保留消息传递顺序

    不保证保留消息和订阅消息传递的顺序。

• $share 是一个文本字符串，用于表示共享订阅的主题筛选条件，该筛选条件必须以 $share 开头。

• {ShareName} 是一个字符串，用于指定一组订阅用户使用的共享名称。共享订阅的主题筛选条件必须包含 ShareName 且后跟 / 字符。{ShareName} 不得包含以下字符：/、+ 或 #。{ShareName} 的最大大小为 128 字节。

• {TopicFilter} 遵循与非共享订阅相同的主题筛选条件语法。{TopicFilter} 的最大大小为 256 字节。

• $share/{ShareName}/{TopicFilter} 所需的两个斜杠（/）不包括在主题和主题筛选条件中的最大斜杠数限制中。

• 当针对 QoS0 订阅用户的发布尝试失败时，不会尝试进行重试，并且消息将被丢弃。

• 当针对具有干净会话的 QoS1 订阅用户的发布尝试失败时，该消息将发送给该组中的另一个订阅用户以尝试进行多次重试。在尝试所有重试后仍未能传送的消息将被丢弃。

• 当针对具有持久性会话的 QoS1 订阅用户的发布尝试因订阅用户处于离线状态而失败时，消息将不会排队，而是会尝试发送给组中的其他订阅用户。在尝试所有重试后仍未能传送的消息将被丢弃。

• 共享订阅不接收保留的消息。

• 当共享订阅包含通配符（# 或 +）时，一个主题可能有多个匹配的共享订阅。如果发生这种情况，消息代理会复制发布消息，并将其发送给每个匹配的共享订阅中的随机客户端。下图可以解释共享订阅的通配符行为。

  

  在此示例中，有三个与发布 MQTT 主题 sports/tennis 匹配的共享订阅。消息代理复制已发布的消息，并将消息发送给每个匹配组中的随机客户端。

  客户端 1 和客户端 2 共享订阅：$share/consumer1/sports/tennis

  客户端 3 和客户端 4 共享订阅：$share/consumer1/sports/#

  客户端 5 和客户端 6 共享订阅：$share/consumer2/sports/tennis

• Amazon IoT 不支持 MQTT 3 的以下数据包：PUBREC、PUBREL 和 PUBCOMP。

• Amazon IoT 不支持 MQTT 5 的以下数据包：PUBREC、PUBREL、PUBCOMP 和 AUTH。

• Amazon IoT 不支持 MQTT 5 服务器重定向。

• Amazon IoT 仅支持 MQTT 服务质量 (QoS) 级别 0 和 1。 Amazon IoT 不支持以 QoS 级别 2 发布或订阅。在请求 QoS 级别 2 时，消息代理不会发送 PUBACK 或 SUBACK。

• 在中 Amazon IoT，订阅 QoS 级别为 0 的主题意味着消息的传送次数为零次或多次。消息可能会多次发送。多次发送的消息在发送时可能会使用不同的数据包 ID。在这些情况下，不会设置 DUP 标志。

• 在响应连接请求时，消息代理将发送 CONNACK 消息。此消息包含一个标志，用于指明该连接是否会恢复上一个会话。

• 在发送其它控制数据包或断开连接请求之前，客户端必须等待从 Amazon IoT 消息代理发送到设备的 CONNACK 消息。

• 当客户端订阅主题时，在消息代理开始发送 SUBACK 和客户端开始收到新的匹配消息之间存在时间延迟。

• 当客户端在订阅主题的主题过滤条件中使用通配符 # 时，主题层次结构中处于及其级别以下的所有字符串均会匹配。但是，父主题不匹配。例如，订阅主题 sensor/# 接收发布到主题sensor/、sensor/temperature、sensor/temperature/room1 的消息，但不是发布到 sensor 的消息。有关通配符的更多信息，请参阅 主题筛选条件。

• 消息代理使用客户端 ID 标识每个客户。客户端 ID 作为 MQTT 负载的一部分从客户端传递到消息代理。客户端 ID 相同的两个客户端无法同时连接到消息代理。当某个客户端使用另一客户端正在使用的客户端 ID 连接到消息代理时，会接受新的客户端连接，而之前连接的客户端会断开连接。

• 在极少数情况下，消息代理可能会使用不同的数据包 ID 再次发送相同的逻辑 PUBLISH 消息。

• 订阅包含通配符的主题筛选条件无法接收保留消息。要接收保留消息，订阅请求必须包含与保留消息主题完全匹配的主题筛选条件。

• 消息代理并不保证收到消息和 ACK 的顺序。

• Amazon IoT 可能有与规格不同的限制。有关更多信息，请参阅《Amazon IoT 参考指南》中的Amazon IoT Core 消息代理和协议限制与限额。

• 不支持 MQTT DUP 标志。