React 17.0.2环境安装radium触发ERESOLVE依赖错误的解决咨询

报错核心原因 #

Radium 0.26.1 版本的 peer 依赖声明范围仅覆盖react@^16.8.0，未将 React 17.x 纳入元数据声明。该版本Radium的实际运行逻辑完全兼容React 17，报错本质为依赖声明范围滞后，不存在实际运行时不兼容问题。

解决方法（无需降级React版本） #

• 直接跳过peer依赖严格校验安装
  执行安装命令：
  npm install --save radium --legacy-peer-deps

  该参数会沿用npm 6版本的依赖处理逻辑，不会因peer依赖范围不匹配直接抛出ERESOLVE错误。如需全局永久生效，可在项目根目录新增.npmrc文件，写入配置legacy-peer-deps=true，后续所有npm操作都会自动跳过peer依赖校验。

• 定向适配radium的依赖规则
  若不想全局开启校验跳过，可利用npm 8.3.0及以上版本支持的overrides字段，单独适配radium的依赖声明：
  在项目根目录的package.json中添加如下配置：

  {
    "overrides": {
      "radium": {
        "react": "$react"
      }
    }
  }
  

  配置完成后重新执行npm install即可完成安装。该方式不会影响其他依赖的peer校验逻辑，仅针对radium的依赖声明做定向匹配。
• 安装兼容React 17的适配版本
  若上述方案出现运行时兼容性问题，可选择经社区验证支持React 17的Radium适配版本安装，规避未经过兼容验证的版本。

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