Flutter应用向AWS S3上传图片时出现400错误求助

问题场景 #

开发Flutter应用时，调用AwsS3.uploadFile上传图片至S3存储桶，返回400状态码，调用参数如下：

await AwsS3.uploadFile(
   accessKey: "myAccessKey",
   secretKey: "mySecretKey",
   file: File(imagePath!),
   bucket: "nameOfMyBucket",
   region: "sa-east-1",
);

打印的请求相关信息：

response.request POST https://myBucket.s3.sa-east-1.amazonaws.com/
response.headers {connection: close, transfer-encoding: chunked, date: Thu, 11 Jan 2024 13:43:08 GMT, x-amz-request-id: ID, content-type: application/xml, x-amz-id-2: ANOTHERID/ID, server: AmazonS3}
response.statusCode 400

排查与解决步骤 #

• 获取完整错误响应体：S3的400错误会在响应体中返回具体错误原因（如InvalidArgument、AccessDenied等），在代码中添加print("response.body ${response.body}")，根据具体错误信息定位问题，这是最直接的排查方式。
• 检查S3存储桶CORS配置：确保存储桶允许你的应用发起POST请求，配置示例如下（生产环境建议限制允许的域名）：

  [
    {
      "AllowedHeaders": ["*"],
      "AllowedMethods": ["POST"],
      "AllowedOrigins": ["*"],
      "ExposeHeaders": []
    }
  ]
  

• 验证IAM凭证权限：确认accessKey和secretKey对应的IAM用户拥有s3:PutObject权限，且策略资源需覆盖存储桶内对象（如arn:aws:s3:::nameOfMyBucket/*，而非仅桶级别arn:aws:s3:::nameOfMyBucket）。
• 补充上传参数：部分S3上传库需要指定key参数（即文件在S3中的存储路径/名称），如果AwsS3.uploadFile未默认生成该参数，需手动补充，示例：

  await AwsS3.uploadFile(
     // 其他参数保持不变
     key: "uploads/${DateTime.now().millisecondsSinceEpoch}.jpg",
  );
  

• 确认存储桶信息正确性：
  • 存储桶名称必须全小写，符合S3命名规则；
  • 确认存储桶确实创建在sa-east-1区域，避免区域不匹配导致域名错误。
• 验证本地文件有效性：检查File(imagePath!)指向的文件是否存在、应用是否拥有读取权限（Android需申请存储权限，iOS需配置相册访问权限），文件损坏或无权限也可能导致请求异常。

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