使用NPM向自托管GitLab实例级npm仓库发布包时报404错误如何解决

• 核心原因：GitLab 实例级 npm registry 端点仅支持包安装操作，不支持发布，你当前配置的@org:registry指向实例级接口，发布请求直接发送到不存在的实例级PUT接口，触发404。
• 项目匹配规则不满足：待发布包@org/package-1对应的GitLab项目必须存放于org群组下，且项目名称为package-1，否则GitLab无法匹配到对应项目资源返回404。
• 访问令牌权限不足：你使用的ACCESS_TOKEN未勾选write_package_registry权限，或令牌所属账号对目标项目权限低于开发者等级。
• .npmrc配置解析失败：部分系统下npm不会自动读取.npmrc中配置的$TOKEN环境变量，导致认证失败触发404。

1. 配置项目级发布端点
   在@org/package-1项目的package.json中新增publishConfig字段，指定发布用的项目级registry：

{
  "name": "@org/package-1",
  "version": "0.1.0",
  "private": false,
  "publishConfig": {
    "@org:registry": "https://gitlab.example.com/api/v4/projects/<PACKAGE_1_PROJECT_ID>/packages/npm/"
  }
}

将<PACKAGE_1_PROJECT_ID>替换为对应GitLab项目的实际数字ID。

2. 校验项目路径匹配
   确认GitLab中对应项目的访问路径为org/package-1，如果群组名或项目名与包名不一致，调整至匹配即可。

3. 校验访问令牌权限
   确认使用的个人访问令牌已勾选write_package_registry权限，且令牌所属账号对目标项目持有开发者及以上角色权限。

4. 修复认证配置
   如果.npmrc中的$TOKEN无法正常解析，可直接执行命令写入令牌：

npm config set //gitlab.example.com/api/v4/projects/<PACKAGE_1_PROJECT_ID>/packages/npm/:_authToken <你的实际ACCESS_TOKEN>

5. 重新发布
   执行命令完成发布：

npm publish

内容的提问来源于stack exchange，提问作者Luke Gareth Ribchester