使用Node.js Firebase Admin SDK操作Firebase Storage的解决方案分享

最近我踩了个实打实的坑——本来想直接用Google Cloud Storage (GCS)做存储操作，结果发现必须要有付费账户才能正常使用，前前后后试了好多次无付费账户的场景都走不通，而且GCS的操作流程实在太繁琐了。本来抱着希望翻Firebase官方文档找办法，结果里面的Functions相关内容完全解决不了我的问题。折腾了半天终于搞定了，特意把解决方案分享出来，帮大家少走弯路！

为什么选Firebase Admin SDK？ #

• 无需GCS付费账户：Firebase Storage本身依托GCS，但通过Admin SDK操作，免费额度内就能正常使用，不用强制升级付费账户
• 操作更简洁：相比GCS的原生API，Admin SDK的接口更贴合Firebase生态，代码写起来更顺手、维护也更简单

具体实现步骤 #

1. 安装Firebase Admin SDK #

先在你的项目里安装依赖（以Node.js为例）：

npm install firebase-admin

2. 初始化Admin SDK #

首先得从Firebase控制台下载服务账号密钥（JSON格式的文件），然后用它初始化SDK：

const admin = require('firebase-admin');
// 替换成你下载的服务账号密钥路径
const serviceAccount = require('./serviceAccountKey.json');

admin.initializeApp({
  credential: admin.credential.cert(serviceAccount),
  // 替换成你的Firebase Storage桶名称，格式是 <项目ID>.appspot.com
  storageBucket: 'your-project-id.appspot.com'
});

// 获取存储桶实例，后续操作都靠它
const bucket = admin.storage().bucket();

3. 常用操作示例 #

上传本地文件到Storage

async function uploadToStorage(localFilePath, destPath) {
  try {
    await bucket.upload(localFilePath, {
      destination: destPath,
      // 可选：设置文件缓存策略、内容类型等元数据
      metadata: {
        cacheControl: 'public, max-age=31536000',
        contentType: 'image/jpeg' // 根据你的文件类型调整
      }
    });
    console.log(`文件已成功上传到：${destPath}`);
  } catch (error) {
    console.error('上传失败：', error);
  }
}

从Storage下载文件到本地

async function downloadFromStorage(sourcePath, localDestPath) {
  try {
    const file = bucket.file(sourcePath);
    await file.download({ destination: localDestPath });
    console.log(`文件已成功下载到：${localDestPath}`);
  } catch (error) {
    console.error('下载失败：', error);
  }
}

删除Storage中的文件

async function deleteFromStorage(filePath) {
  try {
    await bucket.file(filePath).delete();
    console.log(`文件 ${filePath} 已成功删除`);
  } catch (error) {
    console.error('删除失败：', error);
  }
}

亲测这个方法在免费账户下完全能用，而且比直接折腾GCS省心太多，希望能帮到和我一样遇到这个问题的开发者！

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