Firebase Functions私有NPM依赖部署：如何传递NPM_AUTH_TOKEN？

问题原因 #

你本地终端设置的NPM_AUTH_TOKEN无法传递到Firebase部署时使用的Cloud Build容器环境中，导致yarn无法解析.npmrc里的${NPM_AUTH_TOKEN}占位符，从而触发构建失败。

自动化解决方案（适用于CI/CD） #

方案1：动态生成.npmrc文件 #

在CI部署脚本中直接将环境变量写入.npmrc，替代原来的占位符写法，避免yarn在容器中解析变量失败。

执行步骤：

1. 移除或重命名原有的.npmrc文件（避免冲突）
2. 在CI脚本中添加以下命令，动态生成包含真实token的.npmrc：

# 生成私有仓库配置
echo "@example:registry=https://example.com/api/v4/packages/npm/" > .npmrc
# 写入认证token，直接使用CI环境中的NPM_AUTH_TOKEN变量
echo "//example.com/api/packages/npm/:_authToken=${NPM_AUTH_TOKEN}" >> .npmrc
# 执行Firebase部署
firebase deploy --non-interactive -f

方案2：通过Cloud Build传递构建环境变量 #

如果你的CI使用Google Cloud Build作为构建引擎，可以将NPM_AUTH_TOKEN配置为Cloud Build的保密变量，同时调整.npmrc格式避免解析问题：

1. 将原.npmrc修改为（去掉双引号，yarn对带引号的env占位符解析存在兼容问题）：

@example:registry=https://example.com/api/v4/packages/npm/
//example.com/api/packages/npm/:_authToken=${NPM_AUTH_TOKEN}

2. 在Cloud Build中添加保密变量NPM_AUTH_TOKEN（可通过Cloud Console或gcloud命令配置）
3. 部署时通过gcloud命令指定构建环境变量：

gcloud builds submit --config firebase-deploy.yaml --substitutions=NPM_AUTH_TOKEN=$NPM_AUTH_TOKEN

（其中firebase-deploy.yaml是包含Firebase部署步骤的自定义Cloud Build配置文件）

验证要点 #

• 确保CI环境中已正确配置NPM_AUTH_TOKEN变量（比如GitHub Actions Secrets、GitLab CI Variables等）
• 动态生成.npmrc时，需在项目根目录执行命令，保证路径正确

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