Firebase Functions生成Bundle保存至Storage时遇对象不存在错误

可能的问题1：bundleName或querySnapshot未定义 #

代码中直接使用了bundleName和querySnapshot变量，但未看到对应的定义逻辑：

• 若bundleName未定义，生成的文件路径会变成bundles/undefined.xyz，后续操作自然找不到目标对象
• 若querySnapshot未通过查询获取有效快照，bundle.build()会生成无效内容，甚至导致保存操作异常

解决：
补充变量定义逻辑，示例如下：

// 用触发事件的xyzID作为bundle名称
const bundleName = context.params.xyzID;
// 获取对应集合的查询快照
const querySnapshot = await db.collection('xyz').get();

可能的问题2：先设置元数据再保存文件，触发文件不存在报错 #

你先调用file.setMetadata()，但此时文件还未创建（file.save()在之后执行），Storage会因找不到目标对象抛出错误。

解决：
调整操作顺序，或在保存时一并传入元数据：

// 方案1：先保存文件，再设置元数据
await file.save(bundleBuffer, {});
await file.setMetadata({
  "Cache-Control": "public, max-age=86400, s-maxage=86400",
});

// 方案2：保存时直接传入元数据（更高效）
await file.save(bundleBuffer, {
  metadata: {
    "Cache-Control": "public, max-age=86400, s-maxage=86400",
  }
});

可能的问题3：存储桶路径格式错误 #

你传入的桶路径是gs://xxx.appspot.com，但admin.storage().bucket()的参数应使用不带gs://前缀的桶名，或直接留空使用默认桶。

解决：
修正桶初始化代码：

// 使用项目默认存储桶（推荐）
const bucket = admin.storage().bucket();
// 或传入正确格式的桶名
const bucket = admin.storage().bucket("xxx.appspot.com");

可能的问题4：Functions服务账号权限不足 #

Firebase Functions默认服务账号可能没有Storage的写入权限，导致无法创建文件，进而触发“找不到对象”的错误（文件未被成功创建）。

解决：

1. 打开Firebase控制台「项目设置」→「服务账号」，复制「App Engine默认服务账号」的邮箱
2. 打开Cloud Storage控制台，找到目标存储桶，点击「权限」
3. 添加该邮箱为成员，授予「Storage Object Admin」或「Storage Object Creator」权限

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