安装Vite/Next.js项目时遇ERR_SSL_CIPHER_OPERATION_FAILED错误求解决

• 降级Node.js到LTS稳定版
  v22属于Current版本，可能存在SSL相关兼容性问题。建议切换到v20.x系列的LTS版本：

  • 若已安装nvm，执行命令：nvm install 20，随后nvm use 20
  • 未安装nvm的话，直接下载Node.js官网v20.x的安装包覆盖安装

• 临时禁用npm SSL严格模式
  执行以下命令关闭SSL严格校验，之后重新尝试创建项目：

  npm config set strict-ssl false
  npm create vite@latest # 或 npx create-next-app@latest
  

  问题解决后可执行npm config set strict-ssl true恢复默认设置

• 清除npm缓存并切换镜像源
  缓存损坏或源站SSL问题可能导致该错误，执行以下步骤：

  npm cache clean --force
  npm config set registry https://registry.npmmirror.com
  

  完成后再次执行项目创建命令

• 检查并更新系统SSL证书
  打开Windows「Internet选项」→「内容」→「证书」，检查根证书是否过期，更新系统根证书库；也可手动安装最新的根证书包

• 尝试使用其他包管理器
  若npm仍有问题，换用yarn或pnpm尝试：

  • 安装yarn：npm install -g yarn，创建项目：yarn create vite / yarn create next-app
  • 安装pnpm：npm install -g pnpm，创建项目：pnpm create vite / pnpm create next-app

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