Quarkus构建HTTP端点上传文件至AWS S3时遇400错误求助

核心问题定位 #

从错误日志的400状态码来看，大概率是请求参数或环境配置存在问题，结合你的配置与代码，按以下顺序排查：

1. 修正Bucket名称配置 #

你的application.properties中bucket.name带了s3://前缀：

bucket.name=${BUCKET_NAME:s3://fileupload-test} 

AWS S3客户端的bucket参数只需要纯桶名，不需要协议前缀。修改为：

bucket.name=${BUCKET_NAME:fileupload-test} 

2. 验证EKS上的AWS权限配置 #

在EKS环境中使用default凭证类型时，依赖Pod关联的IAM角色（IRSA）：

• 确认Pod绑定的服务账号已关联具备s3:PutObject权限的IAM角色
• 检查IAM角色的信任策略是否允许EKS服务账号执行AssumeRole操作
• 确认S3桶的权限策略允许该IAM角色完成上传操作

3. 确认区域匹配 #

检查S3桶实际所在区域与quarkus.s3.aws.region配置的us-east-1是否一致，区域不匹配会直接导致请求报错。

4. 增加调试日志排查 #

• 在代码中添加日志打印bucketname的值，确认配置是否正确加载：

  // 用Quarkus日志API或直接打印
  LOGGER.info("当前使用的Bucket: {}", bucketname);
  

• 开启AWS SDK调试日志，查看完整请求/响应详情，在application.properties中添加：

  logging.level.software.amazon.awssdk=DEBUG
  

5. 代码优化建议 #

原代码中putResponse != null的判断无意义——AWS SDK的putObject方法失败时会直接抛出异常，不会返回null。调整为异常捕获逻辑：

@Path("/test")
@POST
public Response testEndpoint(){
    String message = "Hello, this is an arbitrary string message!";
    byte[] messageBytes = message.getBytes(StandardCharsets.UTF_8);
    try {
        PutObjectRequest putObjectRequest = PutObjectRequest.builder()
                .bucket(bucketname)
                .key("your-object-key")
                .contentType("text/plain")
                .contentLength((long) messageBytes.length)
                .build();

        s3Client.putObject(putObjectRequest, RequestBody.fromBytes(messageBytes));
        return Response.ok().status(Status.CREATED).build();
    } catch (S3Exception e) {
        LOGGER.error("上传S3失败: {}", e.getMessage());
        return Response.serverError().entity(e.getMessage()).build();
    }
}

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