如何在AWS控制台发送可被amazon-sqs-java-extended-client-lib识别的SQS大消息

我成功实现过这个操作，核心是你漏了库要求的完整S3指针结构和格式校验项，只加ExtendedPayloadSize属性是不够的，以下是具体操作步骤和注意事项：

一、必须满足的两个核心条件 #

1. 消息体（Payload）必须是标准JSON结构 #

消息体不能是随便的S3路径文本，必须严格遵循库定义的JSON格式，包含指定键名（大小写敏感）：

{
  "s3BucketName": "你的S3桶名称",
  "s3Key": "大文件在S3中的完整路径",
  "s3Version": "可选：如果S3桶启用了版本控制，填写对应版本ID"
}

这个JSON结构是库识别"需要从S3下载真实payload"的核心标识。

2. 消息属性必须包含ExtendedPayloadSize #

添加一个String类型的消息属性：

• 属性名：ExtendedPayloadSize
• 属性值：真实大文件的字节数（必须是字符串格式，比如文件大小是350000字节，就填"350000"）

二、完整操作步骤 #

1. 确认S3权限：确保接收消息的应用IAM角色拥有目标S3对象的s3:GetObject权限，避免格式正确但下载失败。
2. 构造消息体：按照上述JSON格式填写S3桶名和文件路径，注意键名大小写不能错。
3. 添加消息属性：在AWS控制台的消息属性区域，新增ExtendedPayloadSize属性，值填文件字节数的字符串形式。
4. 发送消息：完成以上配置后发送消息，接收端的amazon-sqs-java-extended-client-lib会自动识别格式，从S3下载真实payload返回给应用。

三、常见错误排查 #

• 消息体不是标准JSON：比如写成了s3://bucket/path这类文本，库会直接当作普通payload处理。
• ExtendedPayloadSize值格式错误：比如填了数字而非字符串，或者数值与真实文件大小差异过大（部分版本的库会校验大小阈值）。
• 键名大小写错误：比如把s3BucketName写成S3BucketName，库的解析逻辑是严格匹配键名的。

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