Firebase Cloud Functions V1升级V2遇部署报错，求解决方法

问题根源 #

V2 函数名禁止大写，你改用带连字符的function-name后，Firebase CLI 会将连字符解析为对象嵌套属性（即function.name），导致无法找到正确的导出函数，进而引发容器启动失败（函数未加载，自然无法监听端口）。

解决方法 #

方案一：改用下划线命名（最简单） #

将函数名改为下划线格式，通过点语法直接导出，避免解析歧义：

import * as functions from "firebase-functions/v2";
const express = require("express");
const app = express();
app.post(...);

// 改用下划线命名，直接导出
exports.function_name = functions.https.onRequest({region: "asia-southeast2"}, app);

部署命令：

firebase deploy --only functions:function_name

方案二：保留连字符，强制指定函数ID #

如果必须使用连字符，在函数配置中添加functionId字段明确指定函数标识符，确保Firebase能正确识别：

import * as functions from "firebase-functions/v2";
const express = require("express");
const app = express();
app.post(...);

// 添加functionId与导出键一致，强制指定函数名
exports["function-name"] = functions.https.onRequest({
  region: "asia-southeast2",
  functionId: "function-name"
}, app);

部署命令：

firebase deploy --only functions:function-name

额外检查 #

确保Firebase CLI为最新版本，避免旧版本对V2函数的兼容性问题：

npm install -g firebase-tools

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