GitHub Actions构建NextJS静态导出报Firebase auth/argument-error

该错误和Firebase连接代码写法无关，核心诱因是GitHub Action CI构建环境未注入Firebase初始化所需的客户端环境变量。
NextJS开启静态导出（配置output: 'export'）时，构建流程会在Node环境下完成所有客户端代码打包，所有带NEXT_PUBLIC_前缀的环境变量会在构建阶段被硬编码进最终输出的静态资源。本地构建正常是因为本地.env.local文件中存了完整的Firebase配置项，initializeApp可以拿到全部合法参数；但CI环境默认不存在这些变量，传入Firebase初始化逻辑的配置字段存在undefined空值，Firebase Auth参数校验不通过就会抛出auth/argument-error。
本地构建可正常运行的前提下，基本可以排除「构建阶段调用了仅浏览器环境支持的Auth方法」的小众诱因。

• 先核对本地所有Firebase客户端配置的环境变量名，必须全部以NEXT_PUBLIC_为前缀（比如NEXT_PUBLIC_FIREBASE_API_KEY），没有此前缀的变量NextJS不会注入客户端构建流程，构建阶段读取到的值永远是undefined。
• 进入GitHub对应仓库的 Settings > Secrets and variables > Actions 页面，把本地.env.local里所有和Firebase配置相关的、带NEXT_PUBLIC_前缀的变量，逐个添加为仓库Secret，变量名和本地保持完全一致，不要出现拼写错误。
• 修改GitHub Action工作流配置文件，在执行yarn build的步骤中透传上述Secret到构建环境，参考配置片段：

- name: Build static site
  env:
    NEXT_PUBLIC_FIREBASE_API_KEY: ${{ secrets.NEXT_PUBLIC_FIREBASE_API_KEY }}
    NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN: ${{ secrets.NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN }}
    NEXT_PUBLIC_FIREBASE_PROJECT_ID: ${{ secrets.NEXT_PUBLIC_FIREBASE_PROJECT_ID }}
    NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET: ${{ secrets.NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET }}
    NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID: ${{ secrets.NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID }}
    NEXT_PUBLIC_FIREBASE_APP_ID: ${{ secrets.NEXT_PUBLIC_FIREBASE_APP_ID }}
  run: yarn build

• 建议在Firebase初始化逻辑中增加必填参数校验，避免后续再出现环境变量漏配导致的静默错误，参考代码：

import { initializeApp } from "firebase/app";
import { getAuth } from "firebase/auth";

const firebaseConfig = {
  apiKey: process.env.NEXT_PUBLIC_FIREBASE_API_KEY,
  authDomain: process.env.NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN,
  projectId: process.env.NEXT_PUBLIC_FIREBASE_PROJECT_ID,
  storageBucket: process.env.NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET,
  messagingSenderId: process.env.NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID,
  appId: process.env.NEXT_PUBLIC_FIREBASE_APP_ID
};

// 构建阶段校验配置完整性
Object.entries(firebaseConfig).forEach(([field, value]) => {
  if (!value) throw new Error(`Firebase配置缺失字段: ${field}，请检查构建环境变量`);
});

const app = initializeApp(firebaseConfig);
export const auth = getAuth(app);

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