如何使用Admin SDK删除Cloud Storage文件？Firestore触发场景排障

问题根源 #

你直接将完整的Cloud Storage HTTP URL传给bucket().file()方法，导致SDK错误地将URL拼接成了重复的路径。实际上，bucket().file()需要的是存储桶内的相对文件路径，而非完整的HTTP地址。

正确处理方案 #

1. 从Storage URL中提取有效文件路径 #

你的URL格式为http://192.168.1.5:9199/v0/b/example.appspot.com/o/post_images%2F1CA97725-5CF8-4C1B-AD70-674B19A2EE75，其中：

• example.appspot.com是存储桶名称
• post_images%2Fxxx是URL编码后的文件相对路径

可以通过URL解析工具提取并解码路径：

import * as admin from 'firebase-admin';
import { URL } from 'url';

// 从Storage URL中提取解码后的文件相对路径
function getFilePathFromStorageUrl(storageUrl: string): string {
  const urlInstance = new URL(storageUrl);
  // 截取/o/之后的编码路径部分
  const encodedPath = urlInstance.pathname.split('/o/')[1];
  // URL解码得到原始路径
  return decodeURIComponent(encodedPath);
}

// 从Storage URL中提取存储桶名称
function getBucketNameFromStorageUrl(storageUrl: string): string {
  const urlInstance = new URL(storageUrl);
  // 截取/b/之后、/o/之前的桶名部分
  return urlInstance.pathname.split('/b/')[1].split('/')[0];
}

2. 调用Admin SDK执行删除操作 #

先获取对应存储桶，再传入提取后的相对路径执行删除：

// 假设你已经通过对比Firestore前后数据得到待删除的URL数组
const deletedImageUrls: string[] = [/* 待删除的图片URL */];

for (const url of deletedImageUrls) {
  try {
    const bucketName = getBucketNameFromStorageUrl(url);
    const filePath = getFilePathFromStorageUrl(url);
    
    const bucket = admin.storage().bucket(bucketName);
    await bucket.file(filePath).delete();
    
    console.log(`文件 ${filePath} 已成功删除`);
  } catch (err) {
    console.error(`删除URL ${url} 对应文件失败:`, err);
  }
}

核心注意事项 #

• 绝对不能直接将完整HTTP URL传给bucket().file()，必须提取存储桶内的相对路径。
• 必须对URL编码后的路径（如%2F）进行解码，否则SDK会将编码字符视为路径的一部分，导致找不到目标文件。
• 如果始终使用默认存储桶，可以省略桶名提取步骤，直接调用admin.storage().bucket()，但提取桶名的方式能让代码适配多存储桶场景。

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