发布NPM包至GitHub Packages遇EPUBLISHCONFLICT错误，但包已成功发布

向GitHub Packages私有仓库发布NPM包时触发错误：

Error: Cannot publish @user/libs@undefined over existing version.

实际package.json中指定的版本（如1.2.2）在远端仓库并不存在，且最终包仍能以正确版本成功发布，可正常安装使用。

已尝试的操作：

• 通过npm version patch或手动修改更新package.json版本
• 添加匹配的Git标签（如v1.2.2）
• 同步package-lock.json与package.json的版本号
• 删除仓库中所有已发布包
• 执行npm cache clean --force清理缓存
• 切换Node.js 18/20版本测试

详细日志片段（已翻译）：

42 通知 === 压缩包详情 ===
43 通知 名称:          @user/libs
43 通知 版本:       1.2.2
43 通知 文件名:      user-libs-1.2.2.tgz
43 通知 包大小:  93.1 kB
43 通知 解压后大小: 649.3 kB
43 通知 shasum值:        34f4360863d82d5d3101ab8248d8f73610c77f32
43 通知 完整性校验值:     sha512-jamF7x3PnHNR5[...]Z0LOJVSQkIiuA==
43 通知 文件总数:   388
44 通知
45 通知 正在发布至 https://npm.pkg.github.com，标签为latest，默认访问权限
46 HTTP 请求 PUT 返回409 https://npm.pkg.github.com/@user%2flibs 耗时559ms
47 HTTP 请求 GET 返回200 https://npm.pkg.github.com/@user%2flibs?write=true 耗时240ms（缓存已更新）
48 计时 命令:publish 完成 耗时1095ms
49 详细调用栈 Error: 无法发布 @user/libs@undefined，该版本已存在。
49 详细调用栈     在 patchMetadata (/Users/user/.nvm/versions/node/v18.17.1/lib/node_modules/npm/node_modules/libnpmpublish/lib/publish.js:210:7)
49 详细调用栈     在 publish (/Users/user/.nvm/versions/node/v18.17.1/lib/node_modules/npm/node_modules/libnpmpublish/lib/publish.js:76:25)
49 详细调用栈     在 async otplease (/Users/user/.nvm/versions/node/v18.17.1/lib/node_modules/npm/lib/utils/otplease.js:4:12)
49 详细调用栈     在 async Publish.exec (/Users/user/.nvm/versions/node/v18.17.1/lib/node_modules/npm/lib/commands/publish.js:123:7)
49 详细调用栈     在 async module.exports (/Users/user/.nvm/versions/node/v18.17.1/lib/node_modules/npm/lib/cli-entry.js:61:5)
50 详细包ID @user/libs
51 详细工作目录 /Users/user/projects/libs
52 详细系统 Darwin 22.6.0
53 详细Node版本 v18.17.1
54 详细npm版本  v9.8.1
55 错误代码 EPUBLISHCONFLICT
56 发布失败 无法覆盖已有版本发布。
57 发布失败 更新package.json中的'version'字段后重试。
58 发布失败
59 发布失败 如需自动递增版本号，请查看：
60 发布失败     npm help version
61 详细退出码 1

解决思路与方案 #

这个错误的核心是npm发布流程中某个环节读取版本号异常，临时将版本识别为undefined，触发冲突检查错误，但实际上传的压缩包版本正确，所以最终包能成功入库。试试这些方案：

1. 检查.npmrc配置，确保GitHub Packages的registry无冲突：

   # 确认配置内容
   @user:registry=https://npm.pkg.github.com/
   //npm.pkg.github.com/:_authToken=你的认证令牌
   

2. 发布时显式指定版本号：

   npm publish --version 1.2.2
   

3. 排查项目中的自定义发布脚本/钩子（如prepublishOnly），确认没有修改版本号的干扰逻辑
4. 先本地生成压缩包验证版本，再发布：

   npm pack
   npm publish ./user-libs-1.2.2.tgz
   

5. 升级npm到最新稳定版，排除旧版本bug：

   npm install -g npm@latest
   

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