安装NextJS时出现NPM SSL加密错误，该如何解决？

云原生阿岚

2026-6-15

NextJS安装报错ERR_SSL_CIPHER_OPERATION_FAILED的解决方法

问题详情

执行以下命令安装最新版NextJS时：

npx create-next-app@latest

出现SSL加密操作失败的错误：

An error occurred

    npm ERR! code ERR_SSL_CIPHER_OPERATION_FAILED
    npm ERR! C40E0000:error:1C600055:Provider routines:ossl_gcm_stream_update:cipher operation failed:c:\ws\deps\openssl\openssl\providers\implementations\ciphers\ciphercommon_gcm.c:327:npm ERR!
    
    npm ERR! A complete log of this run can be found in:
    npm ERR!     C:\Users\robert\AppData\Local\npm-cache\_logs\2024-12-27T18_34_58_323Z-debug-0.log

已尝试安装新版本OpenSSL，但问题未解决。

解决步骤

临时关闭SSL严格校验
先执行以下命令关闭npm的SSL严格模式：
```
npm set strict-ssl false
```
重新运行安装命令，完成后建议恢复设置：
```
npm set strict-ssl true
```
清理缓存并更换镜像源
1. 强制清理npm缓存：
```
npm cache clean --force
```
1. 切换到国内镜像源（避免网络SSL握手问题）：
```
npm config set registry https://registry.npmmirror.com/
```
1. 再次执行npx create-next-app@latest。
强制Node.js使用内置OpenSSL
设置环境变量让Node使用自身内置的OpenSSL，避免系统版本冲突：
```
set NODE_OPTIONS=--openssl-legacy-provider
```
之后重新运行安装命令。
更新Node.js到最新稳定版
旧版Node.js可能存在SSL组件兼容性问题，卸载当前Node.js版本，安装官方最新稳定版后重试安装操作。