如何从index.ts中单独导出Firebase v2云函数

报错的核心原因是Firebase部署时会执行入口文件的所有顶层代码，哪怕你单独部署某一个v2函数，顶层写死的functions.config()调用也会在v2函数的Cloud Run启动阶段执行，直接触发兼容性报错，和你同时导出v1、v2函数没有直接关系，是顶层初始化逻辑没有做环境隔离导致的。

触发报错的日志原文：Error: functions.config() is no longer available in Cloud Functions for Firebase v2. Please see the latest documentation for information on how to transition to using environment variables

你可以根据自己的项目维护需求，二选一即可：

方案1：环境判断做逻辑隔离（改动最小，适合v1函数存量少的场景） #

核心思路是在入口文件顶层先判断当前运行的函数版本，只在v1环境下执行functions.config()相关逻辑，v2环境下完全跳过这段代码。
v2函数运行时会自动注入PORT=8080的环境变量，你可以直接用这个特征做判断，修改后的入口文件代码参考：

import * as functions from "firebase-functions";
import * as admin from "firebase-admin";

// 判断当前是否为v2运行时
const isV2Env = !!process.env.PORT;

if (isV2Env) {
  // v2环境用默认凭证初始化admin，配置项全部从process.env读取
  admin.initializeApp();
} else {
  // 仅v1环境走旧的config初始化逻辑
  admin.initializeApp(functions.config().firebase);
}

// 正常导出所有版本的函数即可
export { my1GenFunction } from "./my_first_gen_function";
export { my2GenFunction } from "./my_second_gen_function";

部署时注意指定单个函数部署即可，不要全量部署：

• 部署v2函数执行：firebase deploy --only functions:my2GenFunction
• 部署v1函数执行：firebase deploy --only functions:my1GenFunction

这种方案改动量极小，不需要调整项目结构，只要保证v2函数的业务代码内部不调用functions.config()，所有配置从环境变量读取就不会出问题。

方案2：多Codebase物理隔离（适合v1函数存量大，计划逐步迁移到v2的场景） #

用Firebase原生的多代码库能力，把v1和v2函数的入口、部署逻辑完全拆开，从根源上避免代码互相影响，步骤如下：

• 把现有包含functions.config()初始化逻辑的入口文件重命名为index.v1.ts，文件内只保留v1函数的导出和v1专属初始化逻辑
• 新建index.v2.ts作为v2函数专属入口，只导出v2函数，初始化逻辑用v2兼容写法，全程不调用functions.config()
• 修改项目根目录的firebase.json配置，给两个版本的函数指定独立的codebase和入口文件，参考配置：

{
  "functions": [
    {
      "source": "functions",
      "codebase": "v1-legacy",
      "runtime": "nodejs18",
      "main": "index.v1.js"
    },
    {
      "source": "functions",
      "codebase": "v2-new",
      "runtime": "nodejs18",
      "main": "index.v2.js"
    }
  ]
}

配置完成后，两个版本的函数部署完全独立，部署v2函数时根本不会加载v1的入口文件，完全不会触发functions.config()的相关报错，后续全量迁移到v2后，直接删除v1对应的codebase配置即可，维护成本更低。

• v2函数的所有配置项不要用旧的functions.config()读取，统一通过process.env.xxx获取，你可以通过项目内的.env系列文件或者密钥管理工具配置对应环境变量
• 如果是TS项目，环境判断的分支内如果报类型错误，可以在v1分支的functions.config()调用前加// @ts-ignore忽略类型提示，不影响实际运行

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