Firebase Functions SDK 1.0.0 storage.onFinalize() 无法按预期工作

看来你在把Firebase Functions从旧版迁移到v1.0时，遇到了onFinalize触发器不工作的问题，我来帮你排查下常见的坑和修复方案：

首先，理解新旧触发器的核心差异 #

旧版的onChange会在文件创建、更新、删除三种场景下都触发，而v1.0的onFinalize只在文件成功上传完成时触发。如果你测试的是文件删除或更新场景，onFinalize本来就不会触发，这是正常的行为。

代码里的明显错误：废弃的resourceState属性 #

你新代码里写了if (object.resou...，这里有两个问题：

1. 拼写错误：应该是resourceState，但更关键的是——
2. v1.0的onFinalize回调里的object是Storage的ObjectMetadata对象，已经没有resourceState这个属性了！因为onFinalize本身就只对应文件存在的状态，这个判断完全多余，甚至会导致代码报错中断。

修正后的完整代码示例 #

下面是符合v1.0规范的完整代码，包含获取下载URL并写入数据库的逻辑：

// 确保已经导入firebase-admin并初始化
const admin = require('firebase-admin');
admin.initializeApp();

const functions = require('firebase-functions');

exports.processFile = functions.storage.object().onFinalize(async (object, context) => {
  const filePath = object.name;
  const bucketName = object.bucket;

  // onFinalize只在文件上传完成时触发，无需判断资源状态
  try {
    // 获取文件的长期有效下载URL（可按需调整过期时间）
    const file = admin.storage().bucket(bucketName).file(filePath);
    const [downloadUrl] = await file.getSignedUrl({
      action: 'read',
      expires: '2050-12-31'
    });

    // 将URL写入数据库（这里以Firestore为例，可替换为Realtime Database）
    await admin.firestore().collection('uploaded_files').doc(filePath).set({
      downloadUrl: downloadUrl,
      uploadTimestamp: context.timestamp,
      fileName: object.name,
      fileSize: object.size
    });

    console.log(`Successfully processed file: ${filePath}`);
    return null;
  } catch (error) {
    console.error(`Failed to process file ${filePath}:`, error);
    throw error; // 抛出错误触发Functions默认重试机制
  }
});

其他需要排查的点 #

• 更新依赖版本：确保firebase-functions和firebase-admin都是最新版，执行命令：

  npm install firebase-functions@latest firebase-admin@latest
  

• 重新部署函数：用firebase deploy --only functions重新部署，查看部署日志有没有报错信息
• 检查权限配置：确认你的Functions服务账号拥有Storage的读取权限和数据库的写入权限（默认服务账号通常包含这些权限，但若自定义了IAM角色需要验证）
• 测试正确的触发场景：只有当文件完全上传完成时才会触发onFinalize，比如通过Firebase控制台上传完整文件、或用SDK完成上传操作，文件删除/更新不会触发这个函数

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