部署Firebase 2nd Gen函数时遇“There was an error deploying functions”求助

部署Firebase第二代Node.js 22函数时出现错误：

i  functions: updating Node.js 22 (2nd Gen) function helloWorld(us-central1)...

Functions deploy had errors with the following functions:
        helloWorld(us-central1)

Error: There was an error deploying functions

执行firebase functions:log无任何日志输出，调试日志末尾的本地栈追踪如下：

[2025-04-18T19:12:27.812Z] Functions deploy failed.
[2025-04-18T19:12:27.812Z] {}
[2025-04-18T19:12:27.849Z] Error: Precondition failed
    at Fabricator.updateV2Function (/home/aldel/.nvm/versions/node/v20.15.1/lib/node_modules/firebase-tools/lib/deploy/functions/release/fabricator.js:382:19)
    at Fabricator.updateEndpoint (/home/aldel/.nvm/versions/node/v20.15.1/lib/node_modules/firebase-tools/lib/deploy/functions/release/fabricator.js:155:24)
    at /home/aldel/.nvm/versions/node/v20.15.1/lib/node_modules/firebase-tools/lib/deploy/functions/release/fabricator.js:110:71
    at handle (/home/aldel/.nvm/versions/node/v20.15.1/lib/node_modules/firebase-tools/lib/deploy/functions/release/fabricator.js:89:23)
    at Fabricator.applyChangeset (/home/aldel/.nvm/versions/node/v20.15.1/lib/node_modules/firebase-tools/lib/deploy/functions/release/fabricator.js:110:26)
    at /home/aldel/.nvm/versions/node/v20.15.1/lib/node_modules/firebase-tools/lib/deploy/functions/release/fabricator.js:69:40
    at Array.map (<anonymous>)
    at Fabricator.applyPlan (/home/aldel/.nvm/versions/node/v20.15.1/lib/node_modules/firebase-tools/lib/deploy/functions/release/fabricator.js:68:54)
    at release (/home/aldel/.nvm/versions/node/v20.15.1/lib/node_modules/firebase-tools/lib/deploy/functions/release/index.js:76:31)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)

Error: There was an error deploying functions

使用的是新项目中firebase init生成的默认helloWorld函数（仅取消注释），代码如下：

import {onRequest} from "firebase-functions/v2/https";
import * as logger from "firebase-functions/logger";

export const helloWorld = onRequest((request, response) => {
  logger.info("Hello logs!", {structuredData: true});
  response.send("Hello from Firebase!");
});

该函数在本地模拟器运行正常，需排查部署失败原因。

排查步骤 #

• 更新Firebase CLI：栈追踪显示可能存在CLI版本兼容性问题，先执行firebase --version查看当前版本，再运行npm install -g firebase-tools升级到最新稳定版
• 对齐Node.js版本：部署指定Node.js 22，但本地使用的是20.15.1，可修改firebase.json中functions.runtime为nodejs20，切换部署版本后重试
• 清理本地缓存：执行firebase functions:clean清除本地构建缓存，再重新执行firebase deploy --only functions
• 验证权限与云端状态：确认当前登录账号拥有Cloud Functions管理员权限，登录Google Cloud控制台查看是否有残留的函数资源或配置冲突
• 启用详细日志：部署时添加--debug参数获取云端细节，执行firebase deploy --only functions --debug，重点关注云端返回的具体错误提示
• 重建函数依赖：备份代码后，删除functions目录下的node_modules和package-lock.json，重新执行npm install后再部署

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