GitLab CI部署私有Node模块时认证失败问题排查

问题出在哪 #

1. build任务配置有漏洞：build任务直接在script里执行npm ci，虽然先跑了git_config，但生产环境下npm ci会重新拉取依赖，缓存的.npm目录没有私有包的认证信息，而且得确保git配置在npm执行前完全生效才行。
2. 部署到Heroku的核心坑：用dpl把代码推去Heroku后，Heroku自身的构建环境里没有你的GitLab PAT和git配置，所以它执行npm ci时自然无法认证拉取私有包。
3. Git Config的YAML写法有问题：当前的git_config块中，URL替换的引号在YAML解析时可能出现异常，导致git配置未正确生效。

具体怎么修 #

1. 修正Git Config的YAML写法 #

调整git_config的块级字符串，避免引号转义的问题：

.git_config: &git_config |
  git config --global url."https://oauth2:${GITLAB_PERSONAL_ACCESS_TOKEN}@gitlab.com/".insteadOf "https://gitlab.com/"

确保CI能正确替换${GITLAB_PERSONAL_ACCESS_TOKEN}变量，git配置命令可正常执行。

2. 统一测试任务的依赖安装流程 #

修改build任务，和lint、jest保持一致用before_script调用*git_config和依赖安装命令，保证依赖安装前git配置已生效：

build:
  stage: test
  before_script:
    - *git_config
    - NODE_ENV=production npm ci --cache .npm --prefer-offline --ignore-scripts
  script:
    - # 这里添加你的build命令，比如npm run build

3. 解决Heroku部署时拉私有包的问题 #

Heroku构建时无法直接获取GitLab CI的环境变量，可通过以下两种方式处理：

方法一：给Heroku配置Git认证

在Heroku的应用设置中添加环境变量：

• 新增GITLAB_PERSONAL_ACCESS_TOKEN，值为你的GitLab PAT
• 在项目根目录创建.profile.d/git-config.sh文件，内容如下：

git config --global url."https://oauth2:${GITLAB_PERSONAL_ACCESS_TOKEN}@gitlab.com/".insteadOf "https://gitlab.com/"

这个文件会在Heroku构建前自动执行，完成git的URL替换配置。

方法二：使用GitLab的npm仓库（更推荐）

在项目根目录创建.npmrc文件，内容如下：

@myuser:registry=https://gitlab.com/api/v4/packages/npm/
//gitlab.com/api/v4/packages/npm/:_authToken=${GITLAB_PERSONAL_ACCESS_TOKEN}

同时修改package.json中的私有包依赖为npm包格式（需先将私有包发布到GitLab的npm仓库）：

"dependencies": {
  "@myuser/my-dependency": "1.0.0"
}

最后在GitLab CI和Heroku的环境变量中都配置GITLAB_PERSONAL_ACCESS_TOKEN，npm会自动用token认证拉取私有包。

4. 验证CI环境变量的可用性 #

在每个任务的before_script中添加调试命令，确认PAT是否正确加载：

before_script:
  - echo "PAT已加载: ${GITLAB_PERSONAL_ACCESS_TOKEN:+是}"
  - *git_config
  - # 其他命令

如果输出PAT已加载: 是，说明变量正常；如果无输出，检查GitLab CI的环境变量是否设置为Protected或Masked，确保当前分支有权限访问。

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