使用Java SDK上传文件至GCS Bucket遇Postman 415错误求助

首先明确：你当前的代码是直接在程序中上传固定字符串，并非处理HTTP请求的接口代码。出现415错误，是因为你的Web接口（应该是基于这段代码扩展的）没有正确配置来接收Postman上传文件时的multipart/form-data请求类型，同时代码也没有处理实际的文件上传逻辑。

以下是修正后的完整方案：

一、核心问题分析 #

415错误的本质是请求的Content-Type与接口预期不匹配：

• Postman上传文件时默认使用multipart/form-data类型
• 你的接口可能没配置支持该类型，或者参数绑定错误
• 原代码中设置的text/plain是针对字符串内容，上传PEM文件应该用application/x-pem-file（标准PEM文件类型）

二、修正后的代码示例（以Spring Boot接口为例） #

假设你用Spring Boot搭建Web接口，调整代码如下：

import com.google.cloud.storage.*;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;

@RestController
public class GcsPemUploadController {

    // 初始化GCS Storage客户端
    private final Storage storage = StorageOptions.getDefaultInstance().getService();
    // 替换成你已创建的Bucket名称（建议提前在GCP控制台创建，避免重复创建报错）
    private static final String TARGET_BUCKET = "your_unique_bucket";

    @PostMapping("/upload-pem")
    public String uploadPem(@RequestParam("file") MultipartFile file) throws IOException {
        // 校验文件是否为空
        if (file.isEmpty()) {
            return "请选择要上传的PEM文件";
        }

        // 构建GCS Blob信息，设置正确的文件类型
        BlobId blobId = BlobId.of(TARGET_BUCKET, file.getOriginalFilename());
        BlobInfo blobInfo = BlobInfo.newBuilder(blobId)
                .setContentType("application/x-pem-file") // PEM文件标准Content-Type
                .build();

        // 上传文件字节流到GCS
        Blob uploadedBlob = storage.create(blobInfo, file.getBytes());
        return "文件上传成功，Blob路径：" + uploadedBlob.getBlobId();
    }
}

三、Postman正确配置步骤 #

1. 请求方法选择POST，地址填写你的接口地址（比如http://localhost:8080/upload-pem）
2. 切换到Body选项卡，选择form-data类型
3. 新增一个参数：
   • Key填写file（要和接口的@RequestParam参数名一致）
   • Type选择File
   • Value选择本地的PEM文件
4. 不要手动添加Content-Type请求头，Postman会自动生成正确的multipart/form-data头

四、额外注意事项 #

• Bucket创建：不要在接口中重复创建Bucket（Bucket名称全局唯一，重复创建会报错），建议提前在GCP控制台创建好目标Bucket
• 权限配置：确保运行代码的服务账号拥有Storage Object Creator或更高权限（可在GCP IAM控制台配置）
• 文件大小限制：如果上传大文件，建议使用GCS的分块上传API，避免内存溢出

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