Google Cloud Storage上传文件报ApiError: Required 400错误如何解决

算力阿峰

2026-10-3

问题原因

你编写的createBlob函数接收了name参数（指定上传到Bucket后的文件名称），但调用bucket.upload方法时未传入该配置，导致上传请求缺失目标对象名称的必填字段，触发400 Bad Request错误
若GCP Storage客户端初始化时未正确配置认证信息、项目ID等必填参数，也会触发该类报错

修复方案

1. 修正上传代码

在bucket.upload的第二个参数中指定destination字段，绑定你传入的name参数，明确上传后文件在Bucket内的存储路径：

function createBlob(bucketName, name, localFilePath) {
    return new Promise((resolve, reject) => {
        const bucket = gcpStorage.bucket(bucketName);
        bucket.upload(localFilePath, {
            destination: name
        }).then(() => resolve("success")).catch((err) => reject(err))
    });
}

2. 校验GCP客户端初始化配置

确认gcpStorage实例初始化时已配置正确的必填参数，参考初始化代码：

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

// 本地/非GCP环境运行时，使用服务账号密钥文件初始化
const gcpStorage = new Storage({
  keyFilename: '你的服务账号密钥文件本地路径',
  projectId: '你的GCP项目ID'
});

// 运行在GCP托管环境（Cloud Function、GCE、Cloud Run等）时可直接使用默认服务账号，无需额外传参
// const gcpStorage = new Storage();