企业代理环境下npm安装部分包时抛出ECONNRESET错误

问题背景 #

处于企业代理网络环境，npm代理配置如下：

$ npm config get
...
https_proxy = "http://proxy.my-domain.com:8080" 
https-proxy = "http://proxy.my-domain.com:8080" 
proxy = "http://proxy.my-domain.com:8080"
... 

当前配置下，npm i react可成功执行，但安装@babel/core时抛出ECONNRESET错误：

$ npm i @babel/core
npm ERR! code ECONNRESET
npm ERR! syscall read
npm ERR! errno -54
npm ERR! network read ECONNRESET
...

yarn使用相同代理配置可成功安装该包，但会多次提示网络问题并重试：

$ yarn add @babel/core
...
✨  Done in 2.99s.
info There appears to be trouble with your network connection. Retrying...
info There appears to be trouble with your network connection. Retrying...
info There appears to be trouble with your network connection. Retrying...

npm调试日志显示在拉取@jridgewell/*系列依赖时出现连接重置：

73 silly tarball no local data for @jridgewell/sourcemap-codec@https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.14.tgz. Extracting by manifest.
74 silly tarball no local data for @jridgewell/trace-mapping@https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.17.tgz. Extracting by manifest.
75 silly tarball no local data for @jridgewell/set-array@https://registry.npmjs.org/@jridgewell/set-array/-/set-array-1.1.2.tgz. Extracting by manifest.
76 verbose stack Error: read ECONNRESET
76 verbose stack     at TLSWrap.onStreamRead (node:internal/stream_base_commons:217:20)
...

可能原因 #

• 代理处理逻辑差异：yarn对代理连接中断的容错性更强，会自动多次重试直到成功；而npm的重试机制触发条件更严格，遇到连接重置直接抛出错误。
• HTTPS代理适配问题：企业代理通常会做SSL证书拦截，npm默认的严格SSL校验会阻断请求，而yarn可能自动兼容这种场景。
• 依赖请求特性差异：@babel/core的依赖（如@jridgewell/*系列）使用的请求策略，在npm的网络模块中与代理环境适配不佳。
• 版本兼容性bug：当前npm v8.19.1与node v18.9.0的组合，在代理环境下存在网络请求层面的兼容性问题。

解决方案 #

1. 完善npm代理与SSL配置 #

执行命令关闭严格SSL校验（适配企业代理证书拦截），并补全代理参数：

npm config set strict-ssl false
npm config set registry https://registry.npmjs.org/
# 重新确认代理配置
npm config set proxy http://proxy.my-domain.com:8080
npm config set https-proxy http://proxy.my-domain.com:8080
npm config set http-proxy http://proxy.my-domain.com:8080

2. 提升npm网络容错性 #

增加超时时间和重试次数，让npm在不稳定代理环境下有更多重试机会：

npm config set fetch-retry-mintimeout 20000
npm config set fetch-retry-maxtimeout 120000
npm config set retry 5

3. 切换镜像源 #

如果企业有内部npm镜像，或使用国内镜像（如淘宝镜像），可规避公网代理的不稳定问题：

# 切换至淘宝镜像
npm config set registry https://registry.npmmirror.com/

4. 调整npm版本 #

尝试升级npm到最新稳定版，或降级到与node v18兼容性更好的版本：

# 升级npm
npm install -g npm@latest
# 或降级到指定版本
npm install -g npm@8.18.0

5. 补充代理身份认证（若需） #

如果企业代理需要用户名密码，添加对应的认证配置：

npm config set proxy http://username:password@proxy.my-domain.com:8080
npm config set https-proxy http://username:password@proxy.my-domain.com:8080

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