NextJS13+Firebase环境下GitHub Actions密钥配置异常求助

核心问题分析 #

从你的配置和场景来看，导致GitHub Actions无法正确获取密钥的原因主要集中在环境文件匹配、冗余步骤干扰以及验证缺失这几个方面：

1. Next.js 环境文件读取优先级偏差：Next.js 默认在构建阶段优先读取 .env.local，但你当前生成的是 .env 文件，可能导致变量未被框架正确加载。
2. 冗余依赖安装步骤冲突：npm install 和 npm ci 重复执行，npm ci 会覆盖依赖目录且严格遵循锁定文件，可能干扰环境变量的加载时机。
3. 环境变量生成后无验证环节：无法确认变量是否成功注入到环境文件中，难以定位是注入失败还是后续加载问题。

具体修复步骤 #

1. 调整环境文件生成目标为 .env.local #

修改GitHub Actions的环境文件生成步骤，将输出文件名改为Next.js默认读取的 .env.local：

- name: Make envfile
  uses: SpicyPizza/create-envfile@v1
  with:
    NEXT_PUBLIC_API_KEY: ${{ secrets.NEXT_PUBLIC_API_KEY }}
    NEXT_PUBLIC_authDomain: ${{ secrets.NEXT_PUBLIC_AUTHDOMAIN }}
    NEXT_PUBLIC_projectId: ${{ secrets.NEXT_PUBLIC_PROJECTID }}
    NEXT_PUBLIC_storageBucket: ${{ secrets.NEXT_PUBLIC_STORAGEBUCKET }}
    NEXT_PUBLIC_messagingSenderId: ${{ secrets.NEXT_PUBLIC_MESSAGINGSENDERID }}
    NEXT_PUBLIC_appId: ${{ secrets.NEXT_PUBLIC_APPID }}
    NEXT_PUBLIC_measurementId: ${{ secrets.NEXT_PUBLIC_MEASUREMENTID }}
    file_name: .env.local  # 修改为.env.local
    directory: ./

2. 移除冗余的依赖安装步骤 #

删除 npm install 步骤，仅保留 npm ci——它基于锁定文件安装依赖，是CI环境的标准做法：

- run: npm ci
- run: npm run build

3. 添加环境变量验证步骤（调试用） #

在生成环境文件后增加打印步骤，确认变量是否正确注入（验证通过后建议删除，避免敏感信息泄露）：

- name: Verify env file content
  run: cat .env.local

4. 确认GitHub Secrets的有效性 #

• 检查Secrets是否配置在当前仓库的「Settings > Secrets and variables > Actions」下，而非组织或其他仓库。
• 确认触发工作流的分支（main）在Secrets的生效范围内（默认对所有分支生效，若设置了环境分支限制需匹配）。

5. 统一变量命名风格（可选优化） #

当前变量名大小写对应正确，但建议统一使用全大写命名（如 NEXT_PUBLIC_AUTH_DOMAIN），避免驼峰与大写混合的潜在问题，同步更新 config.ts：

const firebaseConfig = {
  apiKey: process.env.NEXT_PUBLIC_API_KEY,
  authDomain: process.env.NEXT_PUBLIC_AUTH_DOMAIN,
  projectId: process.env.NEXT_PUBLIC_PROJECT_ID,
  storageBucket: process.env.NEXT_PUBLIC_STORAGE_BUCKET,
  messagingSenderId: process.env.NEXT_PUBLIC_MESSAGING_SENDER_ID,
  appId: process.env.NEXT_PUBLIC_APP_ID,
  measurementId: process.env.NEXT_PUBLIC_MEASUREMENT_ID,
};

同时更新GitHub Secrets和Actions配置中的变量名即可。

验证修复 #

提交修改后的工作流配置到main分支，触发GitHub Actions构建，查看日志中验证步骤的输出，确认变量已正确注入后，观察构建是否成功完成。

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