使用Node.js上传文件至Google Cloud Storage遇问题求助

我最近在用 Node.js 开发时，碰到了把文件上传到 Google Cloud Storage（GCS）存储桶的问题。我找了一段代码参考，但照着写好后完全跑不起来，折腾了好久都没搞定。

我目前的代码片段是这样的：

const Storage = require('@google-cloud/storage');
const storage = new Storage();
var form = new formidable.IncomingForm();
// form.maxFieldsSize = 20 * 1024 * 1024; // default
form.maxFieldsSize = 20 * 1024;
// form.maxFileSize = 200 * 1024 * 1024; // 4 M...

可能的问题点和修复建议 #

结合我自己踩过的坑，给你列几个常见的排查方向：

• 依赖安装与版本不兼容
  先确认你已经正确安装了 @google-cloud/storage 和 formidable 依赖，版本不匹配很容易出问题。可以执行以下命令重新安装：

  npm install @google-cloud/storage formidable
  

  另外要注意，formidable 新版本（v3+）是 ES 模块，如果你用的是 CommonJS（require 语法），最好指定安装兼容的旧版本：

  npm install formidable@v2.1.2
  

• GCS 身份认证未配置
  Google Cloud Storage 需要身份认证才能操作存储桶，这是最容易忽略的点。你可以通过两种方式配置：

  1. 本地开发时，设置环境变量指向你的服务账号密钥文件：

     export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your-service-account-key.json"
     

  2. 在代码里直接传入密钥配置：

     const storage = new Storage({
       keyFilename: '/path/to/your-service-account-key.json'
     });
     

  要是没配置认证，上传请求肯定会被拒绝。

• Formidable 缺少完整的上传处理逻辑
  你贴的代码只初始化了 Formidable，但没有写核心的文件解析和上传逻辑。完整流程应该是解析表单拿到文件后，再调用 GCS 的上传方法，比如：

  form.parse(req, (err, fields, files) => {
    if (err) {
      console.error('表单解析出错:', err);
      return res.status(500).send('上传失败');
    }
    // 假设前端上传的文件字段名为 'file'
    const uploadedFile = files.file;
    // 指定要上传的存储桶和目标路径
    const bucket = storage.bucket('your-bucket-name');
    const destination = `uploads/${uploadedFile.name}`;
    // 执行上传
    bucket.upload(uploadedFile.path, {
      destination: destination,
      gzip: true,
      metadata: {
        cacheControl: 'public, max-age=31536000',
      },
    })
    .then(() => {
      res.send('文件上传成功');
    })
    .catch(err => {
      console.error('GCS 上传出错:', err);
      res.status(500).send('上传到存储桶失败');
    });
  });
  

  缺少这段关键逻辑的话，自然没法完成文件上传。

• 存储桶权限或名称错误
  确认你的服务账号拥有存储桶的 storage.objects.create 权限，可以在 Google Cloud 控制台的 IAM 页面给服务账号添加「存储对象创建者」角色。另外要注意，GCS 存储桶名称是全局唯一的，别把名称写错了。

• 文件大小限制配置不合理
  你当前设置的 form.maxFieldsSize 只有 20KB，这个值太小了，稍大一点的文件都会上传失败。建议根据需求调整：

  form.maxFieldsSize = 20 * 1024 * 1024; // 20MB
  form.maxFileSize = 200 * 1024 * 1024; // 200MB
  

你可以先从这几个方向排查，尤其是认证配置和 Formidable 的完整流程，这两个是最容易踩坑的点。

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