设置retain为true发布消息时，AWS MQTT Broker为何与客户端断开？

排查与解决步骤 #

• 检查IoT策略权限
  AWS IoT Core的策略必须明确允许目标主题的iot:Publish操作，部分默认策略可能未覆盖retain消息的发布授权。确保策略资源包含你使用的主题路径，示例策略片段：

  {
    "Effect": "Allow",
    "Action": "iot:Publish",
    "Resource": "arn:aws:iot:你的区域ID:你的账户ID:topic/你的主题路径"
  }
  

  若使用通配符主题，需确认覆盖范围包含目标主题，避免因权限不匹配导致Broker主动断开连接。

• 验证消息大小
  AWS IoT Core限制retained消息最大为128KB，超出此大小会直接断开连接且无提示。先发布极小测试内容（如{"test":1}）并设置retain: true，验证是否能正常发布。

• 切换MQTT协议版本
  确认MQTTX使用的协议版本（3.1.1或5.0）与AWS IoT Broker兼容。部分场景下MQTT 5.0的retain消息处理存在兼容性问题，可切换至MQTT 3.1.1重试。

• 清理已存在的保留消息
  若目标主题已有retained消息，且当前客户端无权限覆盖，Broker会断开连接。可通过AWS CLI删除该主题的保留消息后重新测试：

  aws iot delete-retained-message --topic "你的目标主题"
  

• 查看客户端详细日志
  在MQTTX中开启Debug级日志，查看断开前的错误码（如131表示权限不足、143表示消息过大），这些信息能直接定位问题根源。

• 检查会话参数配置
  虽然已设置cleanSession: true，但MQTT 5.0下需确认session expiry interval等参数是否与retain消息处理冲突，可暂时重置客户端会话配置为默认值后重试。

内容的提问来源于stack exchange，提问作者Prabin Upreti