Firebase AppHosting多环境下apphosting.yaml切换失效求助

核心原因 #

Firebase App Hosting 不会自动识别带环境后缀的配置文件，必须显式指定或通过项目别名关联才能加载对应的apphosting.<env>.yaml。

具体解决步骤 #

1. 部署时直接指定配置文件 #

在部署命令中通过--config参数明确指定 staging 环境的配置文件：

firebase apphosting:deploy --config apphosting.stg.yaml

如果是通过 CI/CD 流程部署（比如 GitHub Actions），需要在部署步骤的命令中添加该参数，避免默认读取根目录的apphosting.yaml。

2. 绑定 Firebase 项目别名与配置文件 #

如果你的 staging 环境对应独立的 Firebase 项目别名（比如已通过firebase use stg-project设置），可以在firebase.json中添加环境关联配置，让部署时自动匹配对应配置：

{
  "appHosting": {
    "source": ".",
    "environments": {
      "stg": {
        "config": "apphosting.stg.yaml"
      }
    }
  }
}

之后部署 staging 环境时只需指定项目别名：

firebase apphosting:deploy --project stg-project

3. 检查配置文件命名与路径 #

确认你的配置文件名拼写正确（注意是apphosting.stg.yaml，不要出现拼写错误比如apphsoting.stg.yaml），且文件放在项目根目录下，和默认的apphosting.yaml同级。

4. Next.js 环境变量同步 #

确保apphosting.stg.yaml中的构建命令正确加载 staging 环境的变量，比如：

build:
  command: "npm run build:stg"

同时在项目package.json中配置对应的build:stg脚本，确保构建时注入正确的环境变量，避免和生产环境混淆。

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