按Git分支动态命名Firebase Functions部署失败求助

问题背景 #

需要根据Git分支名动态命名Firebase Functions，通过GitHub Action完成部署。当前index.ts通过循环动态导出函数，process.env.BRANCH_NAME在部署阶段已正确设置，但执行firebase deploy --only functions:<BRANCH_NAME>时，Firebase CLI能识别动态生成的函数名并尝试部署，却在函数创建时提示：

Function 'mybranch.initiateUpdateForPool' is not defined in the provided module.
Did you specify the correct target function to execute?

硬编码分支名或无BRANCH_NAME时部署均正常，说明函数本身逻辑无问题。

核心原因 #

部署阶段（GitHub Action环境）存在BRANCH_NAME，代码会导出带分支前缀的函数名；但Cloud Functions运行时环境中没有该环境变量，导致代码执行时进入else分支，导出原始函数名，与平台期望的带前缀函数名不匹配，最终提示函数未定义。

另外，Firebase CLI部署时可能通过临时执行代码识别到动态函数名，但运行时加载代码的环境与部署环境不一致，导致导出结果不匹配。

解决方案 #

方案1：编译时注入分支名（推荐） #

不在运行时读取环境变量，而是在构建阶段直接将分支名写入代码，让编译后的JavaScript文件固定导出带分支前缀的函数，彻底避免环境变量依赖问题。

在GitHub Action的部署流程中添加以下步骤：

# 提取当前分支名（处理分支名中的特殊字符，确保符合函数名规则）
BRANCH_NAME=$(echo "${GITHUB_REF##*/}" | tr '[:upper:]' '[:lower:]' | sed 's/\//-/g')

# 替换index.ts中的分支名变量为实际值
sed -i "s/const branchName = process.env.BRANCH_NAME/const branchName = \"${BRANCH_NAME}\"/" src/index.ts

# 编译TypeScript（如果需要）
npm run build

# 部署函数
firebase deploy --only functions

方案2：同步运行时环境变量（不推荐） #

若坚持在运行时读取变量，需确保Cloud Functions运行时也配置BRANCH_NAME：

1. 在部署时设置Firebase函数配置：

   firebase functions:config:set branch.name="${BRANCH_NAME}"
   

2. 修改index.ts从Firebase配置中读取分支名：

   import { config } from 'firebase-functions';
   
   const branchName = config().branch.name;
   

此方案弊端明显：多分支部署时会覆盖配置，导致其他分支函数出错，维护成本高。

额外注意事项 #

• Firebase Functions函数名仅支持小写字母、数字、横杠和下划线，需提前处理分支名中的特殊字符（如斜杠、大写字母）。
• 部署命令需匹配实际函数名，例如函数名为mybranch-initiateUpdateForPool，则部署命令应为firebase deploy --only functions:mybranch-initiateUpdateForPool，或用firebase deploy --only functions:*部署所有当前分支函数。

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