React Native依赖冲突问题求助：执行npx react-native doctor时触发ERESOLVE错误

看起来你遇到了典型的npm peer依赖冲突问题，我先帮你梳理下错误核心原因，再给出可行的解决办法：

错误核心分析 #

从你提供的日志能明确看到冲突根源：

• 你的根项目声明需要react-native@0.84.1，这个版本强制依赖react@^19.2.3
• 但当前项目里已经安装了react-native@0.68.2，它依赖的React版本和19.x完全不兼容，导致npm无法解析出符合所有要求的依赖树，最终抛出ERESOLVE错误

完整错误日志 #

npm error code ERESOLVE
npm error ERESOLVE could not resolve

npm error While resolving: undefined@undefined
npm error Found: react-native@0.68.2
npm error node_modules/react-native
npm error   peer react-native@"*" from @react-native-community/cli@7.0.3
npm error   node_modules/@react-native-community/cli
npm error     @react-native-community/cli@"^7.0.3" from react-native@0.68.2
npm error   react-native@"0.84.1" from the root project

npm error Could not resolve dependency:
npm error react-native@"0.84.1" from the root project

npm error Conflicting peer dependency: react@19.2.4
npm error node_modules/react
npm error   peer react@"^19.2.3" from react-native@0.84.1
npm error   node_modules/react-native
npm error     react-native@"0.84.1" from the root project

npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.


npm error For a full report see:
npm error /Users/hasmukhshah/.npm/_logs/2026-03-09T06_14_52_928Z-eresolve-report.txt
npm error A complete log of this run can be found in: /Users/hasmukhshah/.npm/_logs/2026-03-09T06_14_52_928Z-debug-0.log

可行的解决办法 #

1. 确认并修正项目的React Native版本（推荐）

打开项目根目录的package.json，检查react-native的版本号：

• 如果你的实际需求是使用0.68.2，那把版本号从0.84.1改回0.68.2，然后执行：

  rm -rf node_modules package-lock.json
  npm install
  npx react-native doctor
  

• 如果确实要升级到0.84.1，那需要先将React版本升级到^19.2.3，同时确保项目其他依赖都兼容RN 0.84.1版本，再重新安装依赖。

2. 临时绕过冲突（不推荐长期使用）

如果只是想临时运行react-native doctor检查环境，可以用npm提供的参数跳过peer依赖检查：

npx react-native doctor --legacy-peer-deps
# 或者用更激进的force参数
npx react-native doctor --force

注意：这两种方式只是强制npm忽略冲突，可能导致后续项目运行出现未知问题，仅作为临时应急方案。

3. 清理依赖缓存后重新安装

有时候缓存异常也会导致依赖解析出错，尝试清理后重装：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install
npx react-native doctor

备注：内容来源于stack exchange，提问作者Vibhuti