React应用GitLab CI/CD流水线失败：Firebase Token参数缺失

报错error: option '--token <token>' argument missing的核心原因是**firebase use命令不支持直接在命令后添加--token选项**，当前的命令写法不符合Firebase CLI的语法规范。

1. 修正firebase use的命令写法 #

将firebase use $FIREBASE_PROJECT_ID --token $FIREBASE_TOKEN改为以下两种方式之一：

方式一：将--token作为全局参数前置 #

Firebase CLI的全局参数（如--token）需要放在具体命令（use）之前，而非之后：

firebase --token $FIREBASE_TOKEN use $FIREBASE_PROJECT_ID

方式二：依赖环境变量自动读取token #

既然你已在GitLab中配置了$FIREBASE_TOKEN变量，可直接省略命令中的--token参数，Firebase CLI会自动读取环境变量中的值：

firebase use $FIREBASE_PROJECT_ID

这种方式更简洁，也符合Firebase CLI的推荐用法。

2. 其他潜在问题排查 #

• 确认GitLab变量的可见性设置：确保FIREBASE_TOKEN和FIREBASE_PROJECT_ID在流水线运行的分支/环境中可访问（比如不要设置为仅保护分支可见，而测试分支不属于保护分支）。
• 固定firebase-tools版本：不同版本的Firebase CLI可能存在参数格式差异，可指定稳定版本避免问题：

  npm install -g firebase-tools@12.8.1 # 替换为你验证过的稳定版本号
  

修正后的完整流水线脚本示例 #

image: node:latest

.deploy: &deploy
- npm install -g firebase-tools
- firebase use $FIREBASE_PROJECT_ID # 依赖环境变量自动读取token
- yarn
- yarn build

stages:
  - deploy

deploy_preview:
  stage: deploy
  before_script:
    - *deploy
  script: 
    - firebase hosting:channel:deploy $FIREBASE_PROJECT_ID --token $FIREBASE_TOKEN
    - echo "ENVIRONMENT_URL=$(firebase hosting:channel:open live --non-interactive | tail -1 | awk '{ print $3 }')"
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"

staging:
  stage: deploy
  before_script:
    - *deploy
  only:
    - staging
  script:
    - firebase deploy -m "Pipe $CI_PIPELINE_ID Build $CI_BUILD_ID" --only hosting:staging --non-interactive --token $FIREBASE_TOKEN

production:
  stage: deploy
  before_script:
    - *deploy
  only:
    - main
  when: manual
  allow_failure: false
  script:
    - firebase deploy -m "Pipe $CI_PIPELINE_ID Build $CI_BUILD_ID" --only hosting:prod --non-interactive --token $FIREBASE_TOKEN

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