从AWS S3迁移至GCP：Spring Boot分片上传与合并方案问询

GCP Cloud Storage对应的分片上传机制是可恢复上传（Resumable Uploads），以下是对应你AWS S3流程的分步实现方案：

1. 获取等效于AWS Upload ID的标识 #

GCP中没有直接的"Upload ID"，替代的是可恢复上传会话URI（Resumable Upload Session URI）。创建会话时即可生成该URI，后续所有分片上传、合并操作都依赖它。

Spring Boot中用GCS Java客户端实现：

Storage storage = StorageOptions.getDefaultInstance().getService();
BlobInfo blobInfo = BlobInfo.newBuilder(BlobId.of("你的存储桶名", "目标文件路径")).build();
// 生成会话URI，等效于AWS的Upload ID
String sessionUri = storage.createResumableUploadSession(blobInfo);

2. 生成等效的分片签名URL #

GCS没有和S3完全一致的分片签名URL，但可以通过签名的可恢复会话URI实现相同的前端直传效果：

• 若后端生成签名会话，前端可直接用该URI上传分片，无需携带额外凭证
• 也可以生成通用的签名URL，配合Content-Range头实现分片上传

签名会话URI的生成代码：

// 加载服务账号凭证
ServiceAccountCredentials credentials = ServiceAccountCredentials.fromStream(new FileInputStream("service-account-key.json"));
Storage storage = StorageOptions.newBuilder().setCredentials(credentials).build().getService();

BlobInfo blobInfo = BlobInfo.newBuilder(BlobId.of("你的存储桶名", "目标文件路径")).build();
// 设置签名有效期（比如1小时）
Storage.SignUrlOption expiration = Storage.SignUrlOption.expiration(1, TimeUnit.HOURS);
// 生成带签名的会话URI
String signedSessionUri = storage.createResumableUploadSession(blobInfo, Storage.SignUrlOption.signWith(credentials), expiration);

3. 分片上传至GCS的最佳方案 #

使用生成的会话URI，客户端直接发送PUT请求上传分片，核心要求：

• 分片大小建议≥5MB（GCS要求最小分片5MB，最后一个分片可更小）
• 每个请求必须携带Content-Range头，格式为bytes [起始字节]-[结束字节]/[总文件大小]，比如bytes 0-5242879/10485760

示例curl请求：

curl -X PUT \
  -H "Content-Range: bytes 0-5242879/10485760" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @part1.bin \
  "你的会话URI"

上传过程中可通过HEAD请求会话URI，获取x-goog-resumable头和已上传字节范围，实现断点续传。

4. Spring Boot服务器端合并分片 #

GCS的可恢复上传无需手动合并分片：当所有分片上传完成后，发送一个空的PUT请求（或上传最后一个分片时），GCS会自动合并为完整文件。

若需在服务器端触发合并或确认上传状态，可通过GCS客户端实现：

// 传入会话URI和总文件大小，完成上传合并
Blob completedBlob = storage.resumeUpload(sessionUri, null, 0, 总文件字节数);
// completedBlob即为合并后的完整文件对象

额外提示 #

• 可恢复会话默认有效期7天，创建时可通过ResumableUploadOptions自定义有效期
• 确保服务账号拥有storage.objects.create和storage.objects.update权限
• 前端上传时，建议捕获上传失败场景，通过HEAD请求恢复断点

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