解决:启动React项目,安装node包报错问题

最新推荐文章于 2025-05-25 14:47:51 发布
最新推荐文章于 2025-05-25 14:47:51 发布
阅读量870 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： 前端开发 javascript 文章标签： node.js 前端
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/m0_58293192/article/details/129582351
在升级到Node.js16.18.0后，使用nvm管理器的用户在React项目中遇到npm安装报错。为了解决不同模块间版本冲突的问题，文章建议使用`npminstall--force`或`npminstall--legacy-peer-deps`命令，允许安装过程忽略peerDependency约束并继续安装，确保不同依赖可以共存。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

因为这个React项目需要高版本的node,我就通过nvm包管理器,切换node版本为16.18.0

但是在项目中 npm i 时报错.

this command with --force, or --legacy-peer-deps
/*
–legacy-peer-deps标志是在v7中引入的，目的是绕过peerDependency自动安装；
它告诉 NPM 忽略项目中引入的各个modules之间的相同modules但不同版本的问题并继续安装，
保证各个引入的依赖之间对自身所使用的不同版本modules共存
*/ 

// 你可以通过 npm install --force  或  npm install --legacy-peer-deps
【taro react】---- 编译微信小程序后报错：Error: Minified React error #321；
止于至善
05-25 2587
1. 错误图片 2. 报错场景 taro 3.2.12 react 编译成微信小程序，微信开发者工具打开编译后的项目报错！ 3. 解决办法 删除 node_modules 文件夹 重新安装，执行 yarn 4. 结果 解决报错！ WXRUI体验二维码 下载 我的博客，欢迎交流！ 我的优快云博客，欢迎交流！ 微信小程序专栏 前端笔记专栏 微信小程序实现部分高德地图功能的DEMO下载 微信小程序实现MUI的部分效果的DEMO下载 微信小程序实现MUI的GIT项目地址 微信小程序实例列表
npm的“--force“和“--legacy-peer-deps“参数
邓邓子的博客
02-02 1万+
-f 或 --force：将强制 npm 获取远程资源，即使磁盘上存在本地副本也是如此。 –legacy-peer-deps：在安装时忽略所有 peerDependencies，采用 npm 版本 4 到版本 6 的样式。
react项目启动失败
m0_37353299的博客
07-16 2339
react项目启动失败： 问题描述： create-react-app创建并且初始化依赖完毕，通过npm start启动失败， 看似一切正常但是这个时候一直卡在准备启动的环境中（Starting the development server…） 原因分析： 这个问题产生的原因是因为windows安全禁止意外的操作打开浏览器和网络 解决方案： 重启一下注意看有没有windows的安全提示信息，如果没有，那就重启电脑，然后再启动一下项目就会有提示，选择同意并且不再提示就可以了 ...
react项目突然启动不了，可能是环境问题
LiuBo_1999的博客
10-28 1253
（报错：环境错误） 重新下载Node.js 完全卸载node.js网址：如何在Mac电脑上完全卸载node.js - 简书https://www.jianshu.com/p/c8473afd7dcb 切换国内镜像 npm install -g mirror-config-china --registry=http://registry.npm.taobao.org 安装sass-loader、node-sass（-D 是 --save-dev 的简写） npm install sass-loa
--legacy-peer-deps 是什么意思
wangwenzhe的博客
05-25 605
-legacy-peer-deps 是什么意思是 npm（Node Package Manager）中的一个命令行标志，主要用于解决依赖管理中的兼容性问题，尤其是在处理 peer dependencies（对等依赖）时。
npm install 报错 this command with --force, or --legacy-peer-deps
Jinying_211125的博客
11-02 7600
npm install 报错 this command with --force, or --legacy-peer-deps
npm install报错 Fix the upstream dependency conflict, or retrynpm ERR! this command with --forc
Bunny的博客
01-15 4973
其实说的也对，但是如果每次元件这个问题都这么做的话难免很麻烦，而且不太像真正的解决问题。这个问题解决方式有三种(我目前知道的)，网上很多都说在。使用这个命令，每次安装时自动执行，也就是默认选项为。
vue的脚手架中安装vant包报错
weixin_45650998的博客
09-02 1856
【翻译】解决方法，命令后面添加–force, or --legacy-peer-deps。【翻译】修复上流环境依赖冲突，或者重试。
npx create-react-app xxx创建项目报错的解决办法
11-21
根据React官方文档（上图）可以发现，此时并不需要安装create-react-app工具，只要你的node >= 8.10 && npm >= 5.6，就可以直接使用npx create-react-app命令来创建项目。 报错 好的:OK_hand:，那就根据上面的来呗，...
React TS JSX项目自动化配置，打包build报错问题解决
weixin_43837305的博客
01-14 2414
文章目录前言一、项目打包二、Jenkins自动化部署1.配置编译打包命令2.参考文献3.最终解决总结 前言 提示：本页面解决方法慎重参考，本人是在自己公司的项目发现的build问题，不代表所有项目都有这个问题，请明确后再参考 提示：以下是本篇文章正文内容，下面案例可供参考 一、项目打包 基本的md配置，本项目使用的是yarn管理工具。 本地安装依赖正常，打包正常 二、Jenkins自动化部署 1.配置编译打包命令 正常按照本地打包命令执行:yarn、yarn build:dev dev是自己配置的
web项目启动解决报错---Error: error:0308010C:digital envelope routines::unsupported
qq_41655898的博客
08-15 836
node版本在 17+版本后增加了OpenSSL3.0，对允许算法和密钥大小增加了严格的限制。
插件版本冲突问题记录
Winsom1的博客
08-31 557
3.使用 --force 或 --legacy-peer-deps： 如果你确定解决版本冲突后不会出现其他问题，你可以尝试使用 --force 或 --legacy-peer-deps 参数来强制解决依赖冲突。2.安装最新版本【@latest】的（例如： babel-loader：在确认依赖关系兼容后，重新安装最新版本的 babel-loader）。1.使用 --legacy-peer-deps 参数： 运行命令时使用 --legacy-peer-deps 参数，可能会避免一些版本冲突。
npm 执行安装报错
GodLoveMe的博客
03-07 1234
主要的原因是 npm7 以上的版本，新增了一个对等依赖的特性，在以前的版本上，只会显示警告，但是还是可以安装成功，然而在新的版本是，npm 安装依赖则会直接报错，无法安装，这也是为了应用更加健壮而加的新的特性吧！参数，这个参数保持跟旧版本一样的安装模块，忽略对等依赖。如果要保持旧的安装模块方法，可以尝试。
npm install时遇到的问题
weixin_43825727的博客
03-10 8084
最近在分析开源项目el-admin，运行前端部分项目时，npm install遇到了bug 之前在其他项目中运行npm install都不存在该问题 E:\myprojects\el-admin\eladmin-web-master>npm install npm ERR! code ERESOLVE npm ERR! ERESOLVE unable to resolve dependency tree npm ERR! npm ERR! Found: @babel/core@7.0.0 npm E
解决 npm 执行 install 安装依赖时出现 ERESOLVE 错误
热门推荐
学Java的小前端的博客
03-23 2万+
错误如下： npm ERR! code ERESOLVE npm ERR! ERESOLVE unable to resolve dependency tree npm ERR! npm ERR! While resolving: cloudeyes@1.0.0 npm ERR! Found: sass-loader@7.3.1 npm ERR! node_modules/typescript npm ERR! dev sass-loader@"7.3.1" from the root project
node_modules/@types/react/inddex.d.ts 不是模块
平凡的心
09-20 2657
node_modules/@types/react/inddex.d.ts 不是模块....
npm Fix the upstream dependency conflict, or retry this command with -- force, or -legacy-peer-deps
weixin_44149940的博客
02-07 2890
npm Fix the upstream dependency conflict, or retry this command with -- force, or -legacy-peer-deps
运行react项目后报错error:03000086:digital envelope rpotins::initialization error
最新发布
07-16
<think>我们参考了多个关于类似错误的解决方案，这些错误通常与Node.js版本过高导致的OpenSSL兼容性问题有关。根据引用[2][3][4]，主要解决方案有两种：降级Node.js版本或设置环境变量使用旧版OpenSSL提供程序。 针对React项目出现的相同错误，我们推荐以下两种解决方案： ### 解决方案1：设置环境变量（临时） 在运行React项目前，设置`NODE_OPTIONS`环境变量为`--openssl-legacy-provider`。根据操作系统不同，命令如下： - **Windows (PowerShell)**： ```bash $env:NODE_OPTIONS="--openssl-legacy-provider" npm start ``` 或者使用cmd： ```bash set NODE_OPTIONS=--openssl-legacy-provider npm start ``` - **Linux/macOS**： ```bash export NODE_OPTIONS=--openssl-legacy-provider npm start ``` ### 解决方案2：修改package.json脚本（持久化） 在`package.json`文件的`scripts`部分，将启动命令修改为包含环境变量设置的形式： ```json "scripts": { "start": "react-scripts start", // 改为： "start": "set NODE_OPTIONS=--openssl-legacy-provider && react-scripts start" // Windows // 或 "start": "export NODE_OPTIONS=--openssl-legacy-provider && react-scripts start" // Linux/macOS } ``` ### 解决方案3：降级Node.js版本 如果上述方法无效，考虑降级Node.js至长期支持版本（如16.x或18.x）。使用工具如`nvm`（Node Version Manager）可以方便地切换版本： 1. 安装nvm（如果尚未安装）： - Windows: [nvm-windows](https://github.com/coreybutler/nvm-windows) - Linux/macOS: [nvm](https://github.com/nvm-sh/nvm) 2. 安装并切换至兼容版本（例如18.x）： ```bash nvm install 18 nvm use 18 ``` ### 原因分析 该错误通常发生在Node.js v17+版本，因为其默认使用OpenSSL 3.0，而一些旧项目依赖的库可能不兼容。设置`--openssl-legacy-provider`可以让Node.js回退到旧版提供程序[^2][^3]。 §§相关问题§§ 1. 如何检查当前Node.js版本和OpenSSL版本？ 2. 除了OpenSSL问题，还有哪些常见原因导致React项目启动失败？ 3. 如何永久设置环境变量以避免每次手动输入？</think>### 解决 React 项目报错 `error:03000086:digital envelope routines::initialization error` 此错误通常由 **Node.js 版本过高（v17+）** 与项目依赖的加密模块不兼容引起。以下是已验证的解决方案： --- #### ✅ 方案 1：临时设置环境变量（推荐） 在运行命令前添加环境变量设置： ```bash # Windows（PowerShell） $env:NODE_OPTIONS="--openssl-legacy-provider" npm start # Windows（CMD） set NODE_OPTIONS=--openssl-legacy-provider && npm start # Linux/macOS export NODE_OPTIONS=--openssl-legacy-provider npm start ``` > **原理**：强制 Node.js 使用旧版 OpenSSL 提供程序兼容老项目[^2][^4] --- #### ✅ 方案 2：永久修改 package.json 在 `scripts` 中添加环境变量： ```json // package.json "scripts": { "start": "react-scripts start", // 修改为 ↓ "start": "set NODE_OPTIONS=--openssl-legacy-provider && react-scripts start" // Windows // 或 "start": "export NODE_OPTIONS=--openssl-legacy-provider && react-scripts start" // Linux/macOS } ``` > 修改后执行 `npm start` 即可[^3] --- #### ✅ 方案 3：降级 Node.js 版本 1. 安装 Node.js LTS 版本（推荐 v16.x）： ```bash nvm install 16.20.2 # 使用 nvm nvm use 16.20.2 ``` 2. 删除 `node_modules` 并重新安装依赖： ```bash rm -rf node_modules package-lock.json npm install ``` --- #### ✅ 方案 4：全局环境变量（Windows） 1. 打开系统设置：`控制面板 > 系统 > 高级系统设置 > 环境变量` 2. 新建系统变量： - 变量名：`NODE_OPTIONS` - 变量值：`--openssl-legacy-provider` 3. 重启终端后运行 `npm start`[^4] --- ### 原因说明 此错误因 **Node.js v17+ 默认使用 OpenSSL 3.0**，而旧项目依赖的加密库（如 Webpack 4）需要兼容模式。解决方案本质是启用旧版加密支持[^2][^3]。 > 📌 **提示**：若使用 React 18+ 和 Webpack 5，建议升级依赖而非降级 Node.js。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

开发那点事儿~

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值