NPM发布失败报错“Parse Error: Invalid major version”是什么原因？

报错根因与排查方案 #

HPE_INVALID_VERSION属于Node.js底层HTTP解析器抛出的错误，和你包本身的版本号没有关联，不要被错误提示里的version描述误导，可按以下优先级排查：

1. 替换registry为HTTPS协议 #

npm官方registry从2021年开始已经全面强制HTTPS访问，你当前配置的HTTP源会触发强制重定向，旧版本npm的HTTP解析器处理带编码的重定向路径时会触发该解析错误。
先执行以下命令校验并修改源配置：

# 查看当前配置的源
npm config get registry
# 如果输出为http://registry.npmjs.org/，替换为HTTPS版本
npm config set registry https://registry.npmjs.org/

修改后重新执行发布命令即可解决90%以上的同类问题。

2. 路径中的%2f为正常编码 #

路径里的%2f是scoped包路径的标准URL编码格式，不属于异常问题，你在浏览器直接访问未编码路径能打开是因为浏览器会自动完成编码转换，不需要在这个点上做额外排查。

3. 校验Node.js/npm版本兼容性 #

如果你修改源后仍然报错，检查当前使用的工具版本是否存在已知bug：

• Node.js 14.x及更早版本、npm 6.x及更早版本存在多个HTTP解析相关的已知问题，建议升级到Node.js 18.x/20.x LTS版本和配套的npm版本后重试。
• 可使用nvm等版本管理工具快速切换版本做验证，避免全局版本变动影响其他项目。

4. 排查网络中间件干扰 #

如果你本地配置了HTTP代理、抓包工具，或者处于公司内网环境，网络中间件可能会篡改scoped包的请求/响应内容导致解析失败，可尝试关闭代理、切换公网环境后重试发布。

5. 本地预校验 #

执行npm publish --dry-run做本地发布模拟，可提前排查打包、权限、包配置等基础问题，排除包本身的配置错误。

内容的提问来源于stack exchange，提问作者Kevin H.