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

🚀 作者主页: 有来技术

🔥 开源项目: youlai-mall︱vue3-element-admin︱youlai-boot︱vue-uniapp-template

🌺 仓库主页: GitCode︱ Gitee ︱ Github

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

目录

    • 问题描述
    • 原因分析
      • [核心问题: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 特性集。若项目需长期维护,应优先保障基础设施的现代性。

相关推荐
feixing_fx13 小时前
原始类型与引用类型:赋值时到底复制了什么
开发语言·前端·javascript·前端框架
Highcharts.js17 小时前
Highcharts与TypeScript集成指南
前端·javascript·typescript·前端框架·数据可视化·highcharts
feixing_fx1 天前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx1 天前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
feixing_fx1 天前
JavaScript 是什么:从浏览器脚本到通用编程语言
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx4 天前
CSS 变量(Custom Properties):构建可扩展的主题切换系统
前端·css·前端框架·html·css3
ZhengEnCi8 天前
AI Agent 时代前端项目怎么组织:按页面纵向切块,替代按类型分层目录
架构·前端框架·前端工程化
Highcharts.js10 天前
Highcharts Orbit 完全指南:把每一张图表变成交互式分析工具
react.js·前端框架·highcharts·orbit·使用指南·ai 图表·交互式分析工具
多客:duokelijie16 天前
代练订单系统选型思路:跨品类游戏接入、订单分层管理、自动结算逻辑拆解!
数据库·mysql·微信小程序·前端框架·uni-app·php·持续部署
Highcharts.js17 天前
React 中原生支持使用 JSX 组件配置自定义表格 Highcharts Grid
前端·javascript·react.js·前端框架·jsx·highcharts·自定义表格