Jenkins执行npm version时package-lock.json多版本更新提交不全问题排查

可能原因及排查方向 #

1. Jenkins执行环境Git身份配置缺失 #

npm version默认会自动提交package.json、package-lock.json的变更并打版本标签，该逻辑正常执行的前提是当前Git环境已经配置了user.name和user.email。如果Jenkins构建Agent的全局Git身份未配置，npm version执行到提交步骤时会静默失败，仅修改了两个文件的内容但没有生成提交记录，未提交的变更会残留在工作区。等到后续执行git checkout develop时，Git检测到未提交的文件变更，就会阻止分支切换和后续merge操作，完全匹配你标注的失败场景。
本地执行正常是因为开发环境已经提前配置过Git用户信息，npm version的自动提交流程可以正常完成，工作区无残留变更。

2. Jenkins全局npm配置覆盖了默认行为 #

你的流水线中使用了全局的JENKINS_NPMRC配置，该配置可能包含和npm version、lockfile相关的非默认参数：

• 若配置了git-tag-version=false，会导致npm version默认不会自动提交变更，所有修改都会留在工作区
• 若存在lockfile-version、package-lock相关的非默认配置，会导致Jenkins环境生成的package-lock.json结构和本地不一致，执行npm version时就会出现两处version字段同时更新的情况
  可以在Jenkins流水线的npm version步骤前增加sh "npm config list"，输出当前所有npm配置和本地配置对比即可确认。

3. Jenkins工作区残留文件干扰 #

虽然你执行了npm run clean和git reset --hard，但如果你的clean脚本没有删除旧的node_modules目录，或者项目的.gitignore存在和lockfile相关的异常规则，可能导致Jenkins上的package-lock.json是增量生成的，和本地全新生成的结构有差异，执行npm version时就会出现更多字段被更新的情况。可以在npm version执行后增加sh "git status"步骤，确认具体有哪些文件发生了变更、是否处于未提交状态。

临时修复建议 #

1. 在npm version步骤前增加Git身份配置：

git config user.name "CI构建账号"
git config user.email "ci@yourdomain.com"

2. 执行npm version时显式指定参数覆盖全局配置：

npm version ${params.RELEASE_VERSION.toLowerCase()} --git-tag-version=true

3. 在master分支执行完npm version之后、切到develop分支之前，先推送master的变更到远程仓库，避免本地变更和远程冲突。

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