如何在Node.js环境下获取Firebase Storage图片URL的访问token

算力阿峰

2026-9-27

解决方案

错误原因

你当前使用的firebase/storage是面向浏览器端的Web SDK，不支持Node.js服务端环境，因此会出现getDownloadURL is not a function的报错。

正确实现方案

使用专为Node.js服务端设计的Firebase Admin SDK即可生成带签名token的可访问URL，和你需要的效果完全一致。

步骤1：安装依赖

npm install firebase-admin

步骤2：初始化Firebase Admin SDK

首先进入Firebase控制台，在「项目设置」-「服务账号」页下载Node.js对应的服务账号密钥JSON文件，放到你的项目目录中，然后编写初始化代码：

const admin = require('firebase-admin');
// 替换为你自己的服务账号密钥文件路径
const serviceAccount = require('./serviceAccountKey.json');

admin.initializeApp({
  credential: admin.credential.cert(serviceAccount),
  // 替换为你的存储桶名称，和你现有URL里的bucket一致
  storageBucket: 'first-project-17ec7.appspot.com'
});

const storageBucket = admin.storage().bucket();

步骤3：生成可访问的签名URL

Admin SDK通过getSignedUrl方法生成带token的可访问链接，参数支持自定义访问权限、过期时间等：

async function getAccessibleFileUrl(filePath) {
  // filePath为文件在存储桶中的相对路径，你示例的lp.png直接传'lp.png'即可
  const file = storageBucket.file(filePath);
  const [downloadUrl] = await file.getSignedUrl({
    action: 'read',
    // 可自定义过期时间，示例为长期有效，也可写为'1h'（1小时）、'3d'（3天）等格式
    expires: '2099-12-31'
  });
  console.log(downloadUrl);
  return downloadUrl;
}

// 调用测试
getAccessibleFileUrl('lp.png');