如何在Firebase Functions中获取云存储文件的永久公共下载链接

可以实现，首先要明确两类下载链接的区别：

• GCS原生的signed URL：底层签名机制限制最长有效期为7天，是firebase-admin默认存储客户端的标准生成能力
• 你在客户端JS SDK通过getDownloadURL()拿到的永久链接：是Firebase Storage封装的能力，分为两种形式：公开文件的固定访问链接、非公开文件带永久访问令牌的链接，两类都没有过期时间限制

实现方案 #

方案1：公开文件直接构造永久链接（无需依赖额外包）

如果文件允许匿名公开访问，你可以直接手动构造和客户端getDownloadURL()返回结果完全一致的永久链接，无需调用SDK方法：

1. 先给目标文件设置公开读权限，可以通过Storage规则配置，也可以在云函数中通过firebase-admin动态设置：

const { initializeApp } = require('firebase-admin/app');
const { getStorage } = require('firebase-admin/storage');

initializeApp();
const bucket = getStorage().bucket();

async function setFilePublic(filePath) {
  const file = bucket.file(filePath);
  await file.makePublic();
}

2. 按照固定格式拼接链接即可：

https://firebasestorage.googleapis.com/v0/b/<你的存储桶名称>/o/<URL编码后的文件路径>?alt=media

示例代码：

function getPublicPermanentUrl(filePath) {
  const bucketName = bucket.name;
  const encodedPath = encodeURIComponent(filePath);
  return `https://firebasestorage.googleapis.com/v0/b/${bucketName}/o/${encodedPath}?alt=media`;
}

方案2：非公开文件获取带令牌的永久链接

如果文件不允许公开访问，你可以在云函数中安装@firebase/storage客户端SDK，初始化后调用和客户端完全一致的getDownloadURL()方法，即可拿到无过期时间的永久下载链接：

const { initializeApp: initializeClientApp } = require('firebase/app');
const { getStorage: getClientStorage, ref, getDownloadURL } = require('firebase/storage');

// 初始化Firebase客户端SDK（填入你的项目web配置即可）
const firebaseConfig = {
  apiKey: "你的项目API Key",
  authDomain: "你的项目ID.firebaseapp.com",
  projectId: "你的项目ID",
  storageBucket: "你的存储桶名",
  messagingSenderId: "对应配置值",
  appId: "对应配置值"
};

const clientApp = initializeClientApp(firebaseConfig);
const clientStorage = getClientStorage(clientApp);

async function getPermanentDownloadUrl(filePath) {
  const fileRef = ref(clientStorage, filePath);
  return await getDownloadURL(fileRef);
}

注意事项 #

• 非公开文件的带令牌永久链接，只要你不手动重置文件的访问令牌，就会一直有效，安全性等价于客户端生成的同类型链接
• 如果你的下载场景对权限控制要求较高，更推荐使用有效期更短的signed URL，每次用户请求时实时生成，避免链接泄露后被长期滥用

内容的提问来源于stack exchange，提问作者Wt.N