pnpm install报错ERR_SSL_PACKET_LENGTH_TOO_LONG问题解决

开发者联盟league2026-06-17 8:18

报错内容

bash 复制代码

[WARN] GET https://registry.npmmirror.com/stack-trace/-/stack-trace-0.0.9.tgz error (ERR_SSL_PACKET_LENGTH_TOO_LONG). Will retry in 1 minute. 1 retries left.

根本原因

{ssh-host}到 registry.npmmirror.com（国内 npm 镜像）的网络连接不稳定，HTTPS 请求经常收到异常的 SSL 数据包，导致 ERR_SSL_PACKET_LENGTH_TOO_LONG 错误。

解决步骤

1. 切换到 npm 官方源

测试发现 registry.npmjs.org 在远端机器上可以正常访问：

bash 复制代码

curl -sI https://registry.npmjs.org/vis-data
# 返回 HTTP/2 200，正常

而 npmmirror 虽然 API 能访问，但 tarball 下载频繁超时和 SSL 异常。

2. 关闭 strict-ssl

Node.js 24 的 TLS 行为与 npmmirror 的 CDN 存在兼容性问题（ERR_SSL_PACKET_LENGTH_TOO_LONG），通过关闭严格 SSL 校验绕过：

复制代码

strict-ssl=false

3. 增大重试参数

因为网络本身慢（20-40 KiB/s），增大超时和重试次数避免误杀：

复制代码

fetch-retries=5
fetch-retry-maxtimeout=120000
fetch-retry-mintimeout=10000

4. 最终配置（.npmrc）

在仓库根目录创建了 .npmrc：

复制代码

registry=https://registry.npmjs.org/
strict-ssl=false
fetch-retries=5
fetch-retry-maxtimeout=120000
fetch-retry-mintimeout=10000

5. 执行安装

bash 复制代码

pnpm install --no-verify-store --no-frozen-lockfile

--no-frozen-lockfile 让它用 npmjs.org 重新解析依赖地址，--no-verify-store 跳过 store 完整性校验避免额外的网络开销。

一句话总结

从不通的 npmmirror 切换到通的 npmjs.org，关掉 SSL 严格校验，拉大重试窗口。