Firebase Cloud Functions中Storage的ref函数报错问题求助

问题根源 #

你混淆了Firebase客户端SDK和Firebase Admin SDK的Storage API用法。Admin SDK v10+的Storage模块不再使用ref函数，而是通过Bucket对象操作存储资源，直接导入客户端风格的ref会导致ref is not a function错误。

修正步骤 #

1. 调整导入语句：移除不需要的ref、uploadString、getDownloadURL导入，改用Admin SDK的Bucket相关方法。
2. 使用Bucket对象操作文件：通过getStorage().bucket()获取存储桶实例，用file()方法创建文件引用。
3. 处理Base64上传：将Base64字符串转换为Buffer，调用save()方法上传。
4. 生成下载URL：使用getSignedUrl()生成可访问的链接（注意配置有效期和权限）。

修改后的完整代码 #

const functions = require("firebase-functions");
const cors = require("cors")({ origin: true });
const { getFirestore } = require("firebase-admin/firestore");
const { getStorage } = require("firebase-admin/storage");

exports.initResponse = functions.https.onRequest((req, res) => {
  cors(req, res, async () => {
    try {
      const db = getFirestore();
      const storage = getStorage();
      // 获取默认存储桶（也可指定自定义桶名：storage.bucket("your-bucket-name")）
      const bucket = storage.bucket();

      const zoopData = req.body;
      const reqId = zoopData.request_id;
      const result = zoopData.result;
      const base64Image = result.best_capture_image;
      console.log(base64Image);

      // 1. 移除Base64前缀（如果有的话，比如"data:image/jpg;base64,"）
      const base64WithoutPrefix = base64Image.replace(/^data:image\/\w+;base64,/, "");
      // 2. 转换为Buffer
      const imageBuffer = Buffer.from(base64WithoutPrefix, "base64");
      // 3. 创建文件引用
      const fileRef = bucket.file(`best_capture_images/${reqId}.jpg`);

      // 上传Buffer到Storage
      await fileRef.save(imageBuffer, {
        contentType: "image/jpeg",
        metadata: {
          cacheControl: "public, max-age=31536000"
        }
      });

      // 生成下载URL（设置有效期为7天，可根据需求调整）
      const [downloadURL] = await fileRef.getSignedUrl({
        action: "read",
        expires: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000)
      });

      console.log("Download URL:", downloadURL);

      res.status(200).json({ success: true, downloadURL });
    } catch (error) {
      console.error("Error uploading image to Firebase Storage:", error.message);
      res.status(500).json({ success: false, error: "Error uploading image to Firebase Storage" });
    }
  });
});

关键说明 #

• Base64前缀处理：如果Zoop返回的base64包含data:image/jpg;base64,这类前缀，必须移除后再转换为Buffer，否则会导致图片损坏。
• 存储桶指定：如果使用非默认存储桶，需要在bucket()方法中传入桶名，例如storage.bucket("my-custom-bucket")。
• 签名URL有效期：getSignedUrl的expires参数可以设置固定日期或相对时间，确保链接安全性。

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