Spring Boot借助AWS S3 SDK上传图片至DigitalOcean Spaces报400错误

核心问题点（按出现概率从高到低排序） #

• 对象键携带前导斜杠
  代码中定义的存储路径"/images/"+ System.currentTimeMillis()+".jpg"开头带有斜杠，DigitalOcean Spaces的S3兼容接口不允许对象键以/起始，会直接判定请求格式非法返回400。需要去掉开头的斜杠，将路径调整为"images/" + System.currentTimeMillis() + ".jpg"。
• Endpoint配置不匹配引发路由错误
  当前传入的Endpoint是拼接了bucket名的完整域名https://myproject.fra1.digitaloceanspaces.com，而AWS S3 SDK默认的虚拟主机访问逻辑，会自动将bucket名拼接到域名最前端，最终生成的请求域名会变成myproject.myproject.fra1.digitaloceanspaces.com，和实际可达的服务域名不匹配就会触发400。
  正确配置应该填写不带bucket名的区域根域名https://fra1.digitaloceanspaces.com，同时开启Path Style访问，让SDK自动将bucket名拼接到请求路径中，适配DigitalOcean Spaces的路由规则。
• 签名算法不兼容
  部分旧版本AWS S3 SDK默认使用V2签名算法，而DigitalOcean Spaces仅支持V4版本签名，签名校验不通过时同样会返回400错误。需要在客户端构建时关闭自动区域发现，强制使用V4签名发起请求。
• 排查方向存在偏差
  你配置的全允许CORS规则和当前报错完全无关：CORS是浏览器侧的跨域访问限制，当前是Java后端直接发起的服务端请求，全程不经过浏览器，CORS规则对这类服务端到服务端的请求没有任何约束作用，不需要在这个方向上投入排查精力。
• 排查完上述问题仍然报错时，可以核对DigitalOcean的Access Key和Secret Key是否填写正确，是否存在前后空格、内容填反的情况，这类凭证校验问题通常返回403，但部分兼容接口适配不严谨时也可能抛出400。

修复后的参考代码 #

AWSCredentialsProvider awscp = new AWSStaticCredentialsProvider(
        new BasicAWSCredentials("你的DigitalOcean Access Key", "你的DigitalOcean Secret Key")
);

AmazonS3 space = AmazonS3ClientBuilder
        .standard()
        .withCredentials(awscp)
        // 配置不带bucket名的区域根Endpoint
        .withEndpointConfiguration(
                new AwsClientBuilder.EndpointConfiguration("https://fra1.digitaloceanspaces.com", "fra1")
        )
        // 开启Path Style访问，适配DO Spaces的请求路由
        .withPathStyleAccessEnabled(true)
        .build();

byte[] byteImage = Base64.getMimeDecoder().decode(data.filePath.split(",")[1]);
InputStream is = new ByteArrayInputStream(byteImage);
ObjectMetadata om = new ObjectMetadata();
om.setContentLength(byteImage.length);
// 使用标准MIME类型替代非标准的image/jpg
om.setContentType("image/jpeg");
// 去掉对象键开头的前导斜杠
String filepath = "images/" + System.currentTimeMillis() + ".jpg";
space.putObject("myproject", filepath, is, om);

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