GitLab实例级NPM仓库配置异常：多包安装返回404错误

1. 先查包的可见性 #

实例级仓库能检索到的包，必须是公开或内部可见的。如果你的包设成了仅项目成员可见的私有包，实例级仓库根本搜不到它。

• 进入GitLab项目的Packages and registries -> Package Registry
• 找到@despliegue/{PACKAGENAME}这个包，把可见性改成“内部”或者“公开”

2. 核对.npmrc配置格式 #

实例级的配置要严格按下面的格式写，别写错路径和认证信息：

@despliegue:registry=https://{URL}/api/v4/packages/npm/
//{URL}/api/v4/packages/npm/:_authToken={TOKEN}

• {URL}就是你的GitLab实例域名（比如gitlab.company.com），别加多余的路径
• {TOKEN}得是拥有实例级读包权限的令牌：个人令牌要勾选read_package_registry，项目令牌得在包所在项目创建，同样勾选读权限

3. 清缓存重试 #

本地npm缓存可能存了旧的仓库信息，先清掉再重新安装：

npm cache clean --force
npm i @despliegue/{PACKAGENAME}

4. 用curl验证包是否在实例仓库里 #

直接发请求查包的信息，确认实例仓库能不能找到它：

curl --header "Authorization: Bearer {TOKEN}" https://{URL}/api/v4/packages/npm/@despliegue%2f{PACKAGENAME}

如果返回404，说明包确实没被实例仓库收录，回去调整包的可见性；要是能拿到包的JSON数据，那就是npm客户端的缓存或配置问题，再重新核对配置细节。

5. 确认令牌权限够不够 #

• 个人令牌：必须勾选read_package_registry，而且令牌所属用户得是包所在项目的成员（如果包是内部可见的话）
• 项目令牌：得在包所在的项目里创建，勾选read_package_registry权限，确保能覆盖实例级仓库的访问范围

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