通过Cloud Functions上传文件至Firebase Storage报错求助

错误原因 #

Firebase Admin SDK的Storage API和前端客户端SDK用法不同，没有ref()方法，需要通过bucket()操作存储桶。另外，Callable Function无法直接接收前端的File对象，必须先做格式转换。

修正方案 #

1. 替换Storage调用方式 #

用admin.storage().bucket()替代admin.storage().ref()，通过存储桶对象创建文件并完成上传。

2. 处理文件参数传递 #

前端需将文件转换为base64字符串传入函数，函数内部解码为Buffer后再上传。

3. 规范错误返回逻辑 #

Callable Function不能直接返回Error对象，必须抛出functions.https.HttpsError类型错误，确保前端能正确捕获并处理。

修正后的完整代码 #

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp(); // 确保初始化Admin SDK

exports.exampleFunction = functions.https.onCall(async (data, context) => {
  // 可选：验证用户身份
  if (!context.auth) {
    throw new functions.https.HttpsError(
      "unauthenticated",
      "用户未登录，无法执行该操作"
    );
  }

  try {
    const someData = {
      some1: "abc",
      some2: "def"
    };

    // 写入数据库并获取新生成的key
    const pushSnapshot = await admin.database()
      .ref(`/level1/${data.dataVar1}/level2/${data.dataVar2}/random`)
      .push(someData);
    const newKey = pushSnapshot.key;

    // 读取数据库目标节点数据
    const dataSnapshot = await admin.database()
      .ref(`/level1/${data.dataVar1}/level2/${data.dataVar2}`)
      .once("value");
    const randomVar = dataSnapshot.val().randomVar;

    // 处理文件上传
    const fileBuffer = Buffer.from(data.fileBase64, "base64");
    const storagePath = `${randomVar}/${newKey}`;
    const bucket = admin.storage().bucket();
    const file = bucket.file(storagePath);

    // 上传文件并设置元数据
    await file.save(fileBuffer, {
      contentType: data.fileType, // 前端传入文件MIME类型，如image/jpeg
      public: true // 若需公开访问则设为true，否则移除该参数
    });

    // 可选：返回文件访问链接
    const [url] = await file.getSignedUrl({
      action: "read",
      expires: "03-01-2500" // 设置链接过期时间
    });

    return {
      success: true,
      fileUrl: url,
      fileKey: newKey
    };
  } catch (error) {
    console.error("操作失败:", error);
    throw new functions.https.HttpsError(
      "internal",
      "文件上传失败",
      error.message
    );
  }
});

前端调用关键代码示例 #

// 选择文件后处理上传逻辑
const file = document.getElementById("fileInput").files[0];
const reader = new FileReader();

reader.onload = async (e) => {
  // 提取base64字符串（去除前缀data:image/jpeg;base64,）
  const base64 = e.target.result.split(",")[1];
  try {
    const callable = firebase.functions().httpsCallable("exampleFunction");
    const result = await callable({
      dataVar1: "xxx",
      dataVar2: "yyy",
      fileBase64: base64,
      fileType: file.type
    });
    console.log("上传成功:", result.data);
  } catch (error) {
    console.error("上传失败:", error);
  }
};

reader.readAsDataURL(file);

注意事项 #

• 确保Cloud Function拥有Storage的读写权限，部署时Firebase会自动配置基础权限，也可在IAM控制台手动调整。
• Callable Function存在10MB请求限制，若上传大文件，建议改用前端直接上传Storage并触发Cloud Function处理后续逻辑，或采用分块上传方案。

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