解决 “crypto.hash is not a function”:Vite 从 6.x 升级至 7.x 后 `pnpm run dev` 报错问题

🚀 作者主页: 有来技术

🔥 开源项目: youlai-mallvue3-element-adminyoulai-bootvue-uniapp-template

🌺 仓库主页: GitCodeGiteeGithub

💖 欢迎点赞 👍 收藏 ⭐评论 📝 如有错误敬请纠正!

目录

    • 问题描述
    • 原因分析
      • [核心问题:Node.js 版本不兼容](#核心问题:Node.js 版本不兼容)
    • 解决方案
      • [✅ 方案一:升级 Node.js 至合规版本(推荐)](#✅ 方案一:升级 Node.js 至合规版本(推荐))
      • [⚠️ 方案二:降级 Vite 至 6.x(临时方案)](#⚠️ 方案二:降级 Vite 至 6.x(临时方案))
    • 技术决策建议

问题描述

将 Vite 从 6.x 升级至 7.x 后,执行 pnpm run dev 时出现以下错误:

bash 复制代码
error when starting dev server:  
TypeError: crypto.hash is not a function

原因分析

核心问题:Node.js 版本不兼容

  • Vite 7 的依赖变更 :Vite 7 内部使用 crypto.hash() 等现代 Web Crypto API,该特性仅在 Node.js 20.19.0+ 或 22.12.0+ 中稳定支持。
  • Node.js 21 的定位问题
    • 21.x 属于非 LTS 版本(奇数版本为实验性分支),API 稳定性低于 LTS 版本。
    • 在 Node.js 21 中 crypto.hash() 未完全实现或存在兼容性差异。

解决方案

✅ 方案一:升级 Node.js 至合规版本(推荐)

  1. 安装符合要求的 Node.js 版本

    bash 复制代码
    # 使用 nvm 切换版本(推荐)
    nvm install 22.12.0
    nvm use 22.12.0
  2. 验证 Node.js 版本

    bash 复制代码
    node -v  # 应输出 v22.12.0 或更高
  3. 重新安装依赖并启动

    bash 复制代码
    pnpm install && pnpm run dev

⚠️ 方案二:降级 Vite 至 6.x(临时方案)

修改 package.json 锁定 Vite 版本至 6.x 最新补丁版本,清除缓存并重新安装依赖。

技术决策建议

从技术演进角度,升级 Node.js + 保留 Vite 7 是最优路径。Node.js 22 作为 LTS 版本(2023 年 10 月发布)已修复大量安全漏洞,并原生支持 ES2025 特性集。若项目需长期维护,应优先保障基础设施的现代性。

相关推荐
EndingCoder7 小时前
安装与环境搭建:准备你的 Electron 开发环境
前端·javascript·electron·前端框架
神州问学9 小时前
Google、OpenAI和Anthropic Agent开发框架哪家强?
前端框架
柯南二号12 小时前
【大前端】React useEffect 详解:从入门到进阶
前端·react.js·前端框架
小猪猪屁14 小时前
告别依赖地狱!Monorepo 打造高效 Vue3 项目体系
前端·前端框架
Tony Peakman17 小时前
dagger.js 实现「CSS 机械键盘」示例解读(对比 React 版本)
javascript·css·react.js·前端框架
天天进步20151 天前
从零到一:现代化充电桩App的React前端参考
前端·react.js·前端框架
知识分享小能手1 天前
React学习教程,从入门到精通, React教程:构建你的第一个 React 应用(1)
前端·javascript·vue.js·学习·react.js·ajax·前端框架
每一天,每一步1 天前
React页面使用ant design Spin加载遮罩指示符自定义成进度条的形式
前端·react.js·前端框架
传奇开心果编程2 天前
【传奇开心果系列】Flet框架实现的图形化界面的PDF转word转换器办公小工具自定义模板
前端·python·学习·ui·前端框架·pdf·word
程序员张32 天前
Vue3+ElementPlus—高效存储和回显多选项的状态值
javascript·vue.js·前端框架