升级Expo SDK 48至51后执行npm install遇依赖解析错误求助

问题根源 #

你的依赖冲突核心是：react-dom@18.3.1要求peer依赖react@^18.3.1，但当前项目锁定的是react@18.2.0，尽管react-native-web@0.19.12同时兼容这两个React版本，但npm的依赖解析器因版本不匹配抛出了错误。

解决方案 #

1. 同步升级React与React DOM（推荐）

直接将React和React DOM升级到满足react-dom要求的版本，这是最稳妥的方案，不会留下潜在兼容性风险：

npm install react@^18.3.1 react-dom@^18.3.1

执行完成后再重新运行npm install即可正常安装依赖。

2. 使用npm兼容模式跳过peer依赖检查

如果暂时不想升级React，可以通过--legacy-peer-deps参数让npm采用旧的依赖解析逻辑，忽略版本冲突：

npm install --legacy-peer-deps

⚠️ 注意：此方法可能会引入潜在的运行时兼容性问题，后续若出现报错，仍需回到方案1升级React版本。

3. 更新react-native-web到兼容版本

Expo SDK 51可能要求react-native-web使用更高版本，建议查看Expo官方文档确认对应版本后执行更新：

npm install react-native-web@latest

更新后重新运行npm install，依赖链冲突可能会自动解决。

额外提示 #

升级Expo SDK时，务必遵循官方升级指南同步更新所有核心依赖，避免因版本不匹配引发类似问题。Expo SDK 51对应的React版本为18.3.1，因此方案1完全符合官方要求。

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