使用Node.js生成的GCS上传签名URL时，多部分头部混入文件内容如何解决？

• Node.js服务器部署在VPS实例中
• Web应用客户端（Vue/Quasar）
• 需同时上传多个大文件（500Mb-1Gb）

1. 客户端向Node.js服务器请求签名URL，服务器处理后返回该URL
2. 客户端通过此签名URL上传文件
3. 上传后GCS中的文件包含多部分流头部，示例内容：

------WebKitFormBoundaryu22DC1TykLzIabb9
Content-Disposition: form-data; name="pozitie corecta obiecte.jpg"; filename="pozitie corecta obiecte.jpg"
Content-Type: image/jpeg

ÿØÿáLExi.... normal jpg file

解决方法 #

问题核心是客户端用multipart/form-data格式封装文件上传，但GCS签名URL期望接收原始文件二进制流，而非表单包装后的内容，对应调整如下：

1. 修改客户端上传逻辑 #

放弃表单提交方式，直接发送文件原始二进制：

• 使用fetch时，直接将文件对象作为请求体，设置对应文件的MIME类型作为Content-Type，不要配置multipart/form-data。示例代码：

const file = document.querySelector('input[type="file"]').files[0];
const response = await fetch(signedUrl, {
  method: 'PUT',
  body: file,
  headers: {
    'Content-Type': file.type
  }
});

• 禁止使用FormData对象，它会自动添加multipart边界和头部，导致文件内容被额外封装。

2. 修正签名URL生成配置 #

Node.js生成GCS签名URL时，确保请求方法为PUT，并指定与客户端一致的内容类型：
示例代码（基于@google-cloud/storage库）：

const { Storage } = require('@google-cloud/storage');
const storage = new Storage();

async function generateSignedUrl(bucketName, fileName, contentType) {
  const options = {
    version: 'v4',
    action: 'write',
    expires: Date.now() + 15 * 60 * 1000, // 15分钟有效期
    contentType: contentType // 必须和客户端上传的Content-Type完全匹配
  };

  const [url] = await storage.bucket(bucketName).file(fileName).getSignedUrl(options);
  return url;
}

3. 大文件上传优化 #

针对500Mb-1Gb的大文件，推荐启用可恢复分块上传，避免网络中断导致上传失败：
生成签名URL时添加resumable: true选项，客户端按照GCS分块上传流程处理即可，既能提升稳定性，也能优化上传速度。

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