无法安装已发布到GCP私有npm registry的scoped包 安装时报E404错误

根因分析 #

• 路径匹配问题：npm客户端生成的私有包tarball下载URL路径，与你.npmrc中配置的认证路径前缀不匹配，导致请求时没有携带GCP认证令牌，触发权限不足报错。
• 仓库路径解析错误：当前scope registry配置不符合GCP Artifact Registry的规则，npm会自动将scope名称拼接到仓库路径中，让GCP误以为你要访问名为@[scope]的不存在的仓库，进而抛出scope不匹配的错误。
• 配置写法兼容问题：你配置中首行registry:https://registry.npmjs.org/=true属于旧版npm配置写法，可能引发配置解析异常。

解决方法 #

1. 修正.npmrc配置，按如下规则调整：

# 替换原有registry配置行，改用标准写法
registry=https://registry.npmjs.org/
@[scope]:registry=https://europe-north1-npm.pkg.dev/[project]/[repo name]/@[scope]/
# 增加全路径前缀的认证配置，避免tarball请求漏传token
//europe-north1-npm.pkg.dev/:_authToken=[gcp auth token]
//europe-north1-npm.pkg.dev/:always-auth=true
//europe-north1-npm.pkg.dev/[project]/[repo name]/:_authToken=[gcp auth token]
//europe-north1-npm.pkg.dev/[project]/[repo name]/:always-auth=true
//registry.npmjs.org/:_authToken=[npm auth token]

2. 清空本地npm缓存，避免旧的错误下载地址残留：

npm cache clean --force

3. 重新执行包安装命令即可正常下载。

验证方案 #

如果修改后仍然报错，可以手动执行npm install @[scope]/[packagename] --verbose查看详细请求日志，确认tarball请求是否携带了认证头，以及请求的URL是否和你的GCP仓库路径匹配。

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