Expo构建React Native应用遇expo doctor依赖版本不匹配问题求助

问题复现 #

运行expo doctor时返回以下依赖版本不匹配错误：

Expected package expo-modules-autolinking@~1.0.0
Found invalid:
  expo-modules-autolinking@0.8.1
  (for more info, run: npm why expo-modules-autolinking)
Expected package @expo/config-plugins@^5.0.2
Found invalid:
  @expo/config-plugins@4.1.5
  @expo/config-plugins@4.1.5
  @expo/config-plugins@2.0.4
  @expo/config-plugins@5.0.1
  @expo/config-plugins@4.1.5
  @expo/config-plugins@4.1.5
  @expo/config-plugins@4.1.5
  (for more info, run: npm why @expo/config-plugins)
Expected package @expo/prebuild-config@^5.0.5
Found invalid:
  @expo/prebuild-config@5.0.3
  @expo/prebuild-config@4.0.4
  (for more info, run: npm why @expo/prebuild-config)

已尝试过的无效方案：

• 升级Expo
• 在package.json中仅添加expo-modules-autolinking的resolutions配置
• 更新Expo模块至最新版本
• 卸载重装npm和Expo

解决方案 #

1. 清理依赖缓存并重新安装 #

彻底清除旧依赖和缓存，避免残留影响：

# 删除依赖目录和锁文件
rm -rf node_modules package-lock.json yarn.lock

# 清理npm缓存
npm cache clean --force

# 重新安装依赖
npm install

2. 完善resolutions配置（强制统一依赖版本） #

在package.json中添加所有不匹配包的resolutions规则，确保所有子依赖使用指定版本：

"resolutions": {
  "expo-modules-autolinking": "~1.0.0",
  "@expo/config-plugins": "^5.0.2",
  "@expo/prebuild-config": "^5.0.5"
}

添加后重新安装依赖（npm需加--force生效，yarn直接运行yarn install）：

npm install --force

3. 使用Expo官方工具对齐版本 #

运行expo upgrade让Expo自动同步所有相关包的版本，确保整体兼容性：

expo upgrade

执行过程中会提示选择Expo SDK版本，建议选择与项目匹配的稳定版本。

4. 排查第三方依赖的兼容性问题 #

如果以上方法仍无效，运行以下命令查看每个不匹配包的依赖来源，定位拖版本后腿的第三方包：

npm why expo-modules-autolinking
npm why @expo/config-plugins
npm why @expo/prebuild-config

根据输出找到对应的第三方依赖，升级该依赖至支持目标Expo版本的最新版，再重新安装依赖。

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