React项目npm安装依赖报ERESOLVE webpack版本冲突错误

问题根因 #

npm v7及以上版本默认开启严格peer依赖校验，本次报错的核心冲突为版本不匹配：

• 项目指定依赖：webpack@^5.55.1
• 项目依赖的css-loader@2.1.1仅声明支持webpack ^4.0.0，与webpack 5版本不兼容
• 项目使用的旧版bootstrap-loader@1.3.3未做严格peer依赖约束，导致依赖树解析时直接触发冲突阻断安装。

可落地方案（按推荐优先级排序） #

方案1：升级css-loader至webpack5兼容版本（最优解，无长期隐患） #

css-loader 5.0及以上版本原生支持webpack 5，升级后可彻底解决版本冲突：

1. 打开项目根目录package.json，在dependencies或devDependencies配置块中找到css-loader字段，将版本号修改为^6.7.3（当前webpack5兼容的稳定版）
2. 清理旧依赖缓存与锁文件，执行以下命令：

rm -rf node_modules package-lock.json

3. 重新执行依赖安装：

npm install

提示：css-loader 6.x版本与2.x版本的配置项存在少量差异，如果升级后webpack启动报配置相关错误，对应调整webpack配置中css-loader的规则参数即可，迁移成本极低。

方案2：替换废弃的bootstrap-loader依赖 #

你当前使用的bootstrap-loader@1.3.3已停止维护多年，本身缺失严格的依赖版本校验，是触发本次冲突的间接原因。如果项目使用Bootstrap 4/5版本，建议直接改用官方推荐的样式引入方式，替换掉该无人维护的依赖，从长期维护层面避免后续出现同类依赖问题。

方案3：临时绕过peer依赖校验（仅适合本地快速调试，禁止生产环境使用） #

如果暂时没有条件调整依赖版本，可以安装时追加参数让npm沿用v6版本的宽松依赖解析逻辑，跳过peer依赖校验：

npm install --legacy-peer-deps

如果上述命令仍安装失败，可追加--force参数强制覆盖安装：

npm install --force

风险提示：这两种方式都会跳过依赖版本兼容性校验，安装的依赖可能存在隐性不兼容问题，项目运行过程中可能出现随机报错，仅可用于临时本地调试场景。

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