React Native克隆项目运行安卓时报错Invariant Violation: "testApp"未注册

通用报错诱因 #

• Metro本地开发服务器从错误目录启动：关闭所有已运行的Metro进程后，在当前项目根目录重新启动即可
• 模块加载异常导致注册逻辑中断：任意依赖或业务模块加载报错时，会阻止AppRegistry.registerComponent执行，直接抛出该错误

Git克隆项目场景专项排查步骤 #

1. 校验应用注册名一致性 #

入口文件（通常为项目根目录index.js或index.android.js）中AppRegistry.registerComponent的第一个参数必须与安卓原生配置的组件名完全匹配，大小写敏感：

安卓端组件名查询路径：android/app/src/main/java/[包名路径]/MainActivity.java，查看getMainComponentName()方法的返回值，或AndroidManifest.xml中package属性对应值需和注册名一致。

2. 清除安卓原生构建缓存 #

仅清除JS侧依赖缓存无法解决原生构建残留问题，执行以下命令清理原生缓存后重新编译：

cd android
./gradlew clean
cd ..

3. 排查Metro端口占用 #

确认8081端口未被其他进程占用，对应查询命令：

• macOS/Linux：lsof -i :8081
• Windows：netstat -ano | findstr 8081
  若存在占用进程，杀死进程后重启Metro和应用即可。

4. 检查自定义打包配置 #

若项目有自定义bundle配置，确认android/app/build.gradle中project.ext.react字段下的entryFile路径指向正确的项目入口文件，无拼写或路径错误。

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