Expo中React Native项目启动报错：DatePickerIOS文件不存在

问题分析 #

这个错误的核心原因是DatePickerIOS在React Native 0.70及以上版本中已被官方移除，但你的项目依赖链里（可能是第三方库、类型定义或Expo内部依赖）仍在尝试导入这个已不存在的模块——哪怕你自己没直接使用它。

解决方案 #

1. 修复Expo与React Native版本兼容性 #

先运行Expo诊断工具排查版本不匹配问题：

npx expo doctor

根据工具提示更新或修复不兼容的依赖，确保expo和react-native版本严格匹配。

2. 定位引用DatePickerIOS的第三方库 #

用命令找出哪个依赖库在引用已废弃的DatePickerIOS：

• macOS/Linux：

  grep -r "DatePickerIOS" node_modules
  

• Windows：

  findstr /s "DatePickerIOS" node_modules
  

找到对应库后，要么更新该库到兼容新版本RN的版本，要么替换为替代组件（比如用expo-date-picker代替旧的日期选择库）。

3. 处理类型定义冲突 #

如果是@types/react-native导致的问题：

• 新版本React Native自带类型定义，无需单独安装@types/react-native，直接删除该依赖：

  npm uninstall @types/react-native
  # 或 yarn remove @types/react-native
  

• 若必须保留，确保其版本与当前react-native版本完全一致。

4. 彻底清除缓存并重装依赖 #

执行以下步骤彻底清理缓存：

1. 删除node_modules、package-lock.json（或yarn.lock）：

   rm -rf node_modules package-lock.json
   # Windows: rd /s /q node_modules & del package-lock.json
   

2. 重新安装依赖：

   npm install
   # 或 yarn install
   

3. 清除Expo和Metro缓存并启动项目：

   npx expo start --clear
   

   额外清除Metro临时缓存（可选）：
   • macOS/Linux：

     rm -rf $TMPDIR/metro-*
     

   • Windows：

     rd /s /q %TEMP%\metro-*
     

5. 检查项目内的类型导入 #

排查项目中的.d.ts类型定义文件或全局配置文件，看是否有手动导入DatePickerIOS的代码，直接删除或替换为expo-date-picker的类型。

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