在现有Android应用中集成React Native时遭遇TypeError: n.createContext is not a function报错求助

我之前在把React Native集成到现有Android项目时，也碰到过完全一样的问题！构建明明显示成功，但一运行就弹出这个错误，真机和模拟器都中招，折腾了好一阵才解决，分享下我的经验：

核心原因分析 #

createContext是React 16.3版本才引入的API，出现这个错误基本可以确定是React版本不兼容或者依赖冲突导致的——要么你的React版本太低，要么项目里混入了多个版本的React库。

具体解决方案 #

• 检查版本兼容性：
  先打开项目根目录的package.json，确认react和react-native的版本是否匹配。比如React Native 0.60+需要React 16.8+以上，React Native 0.59对应React 16.8.3左右。可以运行命令查看当前安装的版本：

  npm list react react-native
  

  如果版本不匹配，修改package.json里的版本号后，执行npm install重新安装依赖。

• 清理缓存与构建文件：
  很多时候缓存会导致旧代码残留，按顺序执行这些操作：

  1. 清理Android项目的构建文件：

     cd android && ./gradlew clean
     

  2. 清理npm缓存：

     npm cache clean --force
     

  3. 删除node_modules文件夹后重新安装依赖：

     rm -rf node_modules && npm install
     

• 重置Metro Bundler缓存：
  启动Metro时加上重置缓存的参数，避免打包旧的代码：

  npx react-native start --reset-cache
  

• 检查原生端依赖配置：
  打开Android项目的settings.gradle和app/build.gradle，确认有没有重复引入React相关的依赖，或者不小心引入了旧版本的React库。确保所有React Native相关的依赖都来自你安装的npm包，而不是手动添加的本地库。

关于官方文档的疏漏 #

说实话，官方集成文档确实没有把版本兼容性这个点放在特别显眼的位置，对于现有项目来说，很容易忽略原本项目的依赖和React Native所需依赖之间的冲突。尤其是当现有Android项目本身就依赖了某个版本的React（比如之前用了React Native的老版本），就会出现这种API缺失的问题。

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