部署Firebase Cloud Functions时使用GitHub私有npm包失败

1. 先修正.npmrc的格式错误 #

你当前的.npmrc把registry地址和认证令牌写在同一行，导致npm无法正确解析令牌，这是触发401错误的核心原因。改成以下正确格式：

@<myOrganizationName>:registry=https://npm.pkg.github.com/
//npm.pkg.github.com/:_authToken=<你的个人访问令牌(PAT)>

拆分两行配置后，npm才能正确识别针对GitHub私有包仓库的认证信息。

2. 确保部署流程能读取到.npmrc #

• 确认.npmrc和package.json放在Cloud Functions的functions目录下，且没有被.gitignore或.firebaseignore文件排除。
• Firebase CLI部署时会默认打包该目录下的所有文件，只要文件存在就会被包含到部署包中。

3. 验证令牌的权限配置 #

你的GitHub个人访问令牌（PAT）需要至少具备以下权限：

• read:packages：用于拉取私有npm包的基础权限
• 如果你的包关联到私有GitHub仓库，还需要添加repo只读权限
  同时要确认：
• 令牌所属的账号已加入目标组织，或者在组织的「Settings > Packages > Access」中已授权该令牌访问私有包。

4. 可选：用Firebase环境变量安全传递令牌 #

如果不想把令牌明文写在.npmrc里，可以通过环境变量注入：

1. 执行命令设置Firebase环境变量：

firebase functions:config:set npm.auth_token="<你的PAT令牌>"

2. 在functions目录的.npmrc中引用该变量：

@<myOrganizationName>:registry=https://npm.pkg.github.com/
//npm.pkg.github.com/:_authToken=${npm_config_npm_auth_token}

部署时Firebase会自动注入该环境变量，npm会读取变量完成认证。

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