GitLab CI/CD发布NPM包至项目仓库遇多类错误，求解决方案

问题1：指定发布到GitLab，却提示需登录registry.npmjs.org #

错误信息 #

npm ERR! code ENEEDAUTH
npm ERR! need auth This command requires you to be logged in to https://registry.npmjs.org/
npm ERR! need auth You need to authorize this machine using `npm adduser`

原因&解决方法 #

只配置了GitLab仓库的认证，但未指定默认发布的registry，npm仍会走默认的npmjs.org地址。正确配置需同时指定registry地址和对应地址的认证：

script:
  - echo "registry=https://${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/" > .npmrc
  - echo "//${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/:_authToken=${CI_JOB_TOKEN}" >> .npmrc
  - npm publish

问题2：Node.js 16+/18版本出现403 Forbidden，Node14可正常运行 #

错误信息 #

npm ERR! code E403
npm ERR! 403 403 Forbidden - PUT https://gitlab.com/api/v4/projects/<project-id>/packages/npm/npm-publish-gitlab

原因&解决方法 #

Node14配套的npm 6与Node16+/18配套的npm 8+在registry认证规则上有差异：npm 8+要求认证必须绑定包的scope，不能直接全局设置registry。

修正方案：

1. 确保package.json中的包名带有GitLab项目的namespace作为scope，例如@your-namespace/your-package
2. 调整.npmrc配置，为对应scope指定registry和token：

script:
  - echo "@${CI_PROJECT_NAMESPACE}:registry=https://${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/" > .npmrc
  - echo "//${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/:_authToken=${CI_JOB_TOKEN}" >> .npmrc
  - npm publish

问题3：进入ui目录发布时出现404 Not Found错误 #

错误信息 #

npm ERR! code E404
npm ERR! 404 Not Found - PUT https://gitlab.com/api/v4/projects/<project-id>/packages/npm/ui

原因&解决方法 #

GitLab的NPM registry要求包必须携带对应项目的scope（即@${CI_PROJECT_NAMESPACE}），无scope的包无法匹配到正确的仓库路径。

解决步骤：

1. 进入ui目录，修改package.json的name字段为@${CI_PROJECT_NAMESPACE}/ui（例如@my-group/ui）
2. 调整CI脚本的.npmrc配置，绑定该scope到GitLab registry：

script:
  - cd ui
  - echo "@${CI_PROJECT_NAMESPACE}:registry=https://${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/" > .npmrc
  - echo "//${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/:_authToken=${CI_JOB_TOKEN}" >> .npmrc
  - npm publish

内容的提问来源于stack exchange，提问作者Code-Apprentice