Firebase Cloud Function中实例化CloudTasksClient触发报错排查

我把Firebase Functions的index.ts精简成了下面的代码，但Firestore文档创建时，Google Cloud日志里出现和new CloudTasksClient()相关的报错。删掉实例化代码只打印简单字符串的话，文档创建后日志正常且无报错，而且@google-cloud/tasks已经更新到最新版本。哪怕只是尝试打印logger.log('CloudTasksClient', CloudTasksClient);而不实例化，还是会触发报错，感觉是导入的问题，但找不到原因，求解决思路？

import { initializeApp } from 'firebase-admin/app';
import * as logger from 'firebase-functions/logger';
import { onDocumentCreated } from 'firebase-functions/v2/firestore';
import { CloudTasksClient } from '@google-cloud/tasks';

initializeApp();

export const onStartSession = onDocumentCreated(
    'userSessionInfo/{userId}/history/{sessionId}',
    async () => {
        const project: string = /* removed */;
        const location: string = 'us-central1';
        const queue: string = 'delay';
        const tasksClient = new CloudTasksClient();
        const queuePath = tasksClient.queuePath(project, location, queue);
        logger.log('queuePath', queuePath);
    },
);

报错信息如下：

Error: Failed to decode protobuf and create a snapshot.
    at entryFromArgs (/workspace/node_modules/firebase-functions/lib/logger/index.js:130:19)
    at Object.error (/workspace/node_modules/firebase-functions/lib/logger/index.js:116:11)
    at createSnapshotFromProtobuf (/workspace/node_modules/firebase-functions/lib/common/providers/firestore.js:61:16)
    at createSnapshot (/workspace/node_modules/firebase-functions/lib/v2/providers/firestore.js:119:59)
    at makeFirestoreEvent (/workspace/node_modules/firebase-functions/lib/v2/providers/firestore.js:156:15)
    at func (/workspace/node_modules/firebase-functions/lib/v2/providers/firestore.js:222:32)
    at /layers/google.nodejs.functions-framework/functions-framework/node_modules/@google-cloud/functions-framework/build/src/function_wrappers.js:113:25
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)

TypeError: Cannot read properties of undefined (reading 'cloud')
    at Function.decode (/workspace/node_modules/firebase-functions/protos/compiledFirestore.js:1529:130)
    at createSnapshotFromProtobuf (/workspace/node_modules/firebase-functions/lib/common/providers/firestore.js:57:52)
    at createSnapshot (/workspace/node_modules/firebase-functions/lib/v2/providers/firestore.js:119:59)
    at makeFirestoreEvent (/workspace/node_modules/firebase-functions/lib/v2/providers/firestore.js:156:15)
    at func (/workspace/node_modules/firebase-functions/lib/v2/providers/firestore.js:222:32)

1. 检查依赖版本兼容性 #

Firebase Functions v2和@google-cloud/tasks可能存在版本冲突：

• 打开package.json确认firebase-functions和@google-cloud/tasks的版本号，尝试将@google-cloud/tasks调整到与当前firebase-functions兼容的版本
• 执行npm ls @google-cloud/tasks查看实际安装的版本，排查是否有嵌套依赖导致的版本不一致

2. 调整导入方式测试 #

尝试改用CommonJS导入语法，排查ES模块导入的兼容问题：

const { CloudTasksClient } = require('@google-cloud/tasks');

同时检查package.json中是否设置了"type": "module"，如果有，建议移除该配置（Firebase Functions默认支持CommonJS，ES模块可能引发加载异常）

3. 强制统一protobuf依赖版本 #

报错核心是protobuf解码失败，大概率是@google-cloud/tasks和firebase-functions依赖的protobuf版本不一致：

• 执行npm ls protobufjs查看所有依赖的protobuf版本，确认是否存在多版本共存的情况
• 在package.json中添加resolutions字段强制统一版本（npm需配合npm-force-resolutions工具，yarn直接支持）：

  "resolutions": {
    "protobufjs": "7.2.5" // 替换为当前firebase-functions依赖的具体版本
  }
  

• 清理依赖后重新安装：rm -rf node_modules package-lock.json && npm install

4. 本地模拟器调试 #

用Firebase Emulator本地运行函数，更容易定位问题：

• 启动模拟器：firebase emulators:start --only functions,firestore
• 创建测试文档，查看本地日志的详细报错信息，可能会得到更明确的调试线索

5. 对齐运行环境Node.js版本 #

Firebase Functions v2默认使用Node.js 18，确保本地开发环境与线上运行时版本一致：

• 检查firebase.json中的functions.runtime字段，确认设置为nodejs18或兼容版本
• 本地Node.js版本尽量与线上保持一致，避免版本差异导致的模块加载问题

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