React Native报错求助：TurboModuleRegistry无法找到AppAmbitCore模块

问题详情 #

应用启动时触发错误：

[runtime not ready]: 不变违规：TurboModuleRegistry.getEnforcing(...)：找不到 'AppAmbitCore'。请验证该模块已在原生二进制文件中注册。

已尝试以下方案但均未解决问题：

• 清理项目并重新运行
• 通过Claude和Antigravity寻求解决方法

附完整堆栈追踪（已翻译）：

[runtime not ready]: 不变违规：TurboModuleRegistry.getEnforcing(...)：找不到 'AppAmbitCore'。请验证该模块已在原生二进制文件中注册。

invariant
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:200667:25
getEnforcing
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:200630:27
匿名函数
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:295756:80
loadModuleImplementation
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:260:13
guardedLoadModule
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:168:37
metroRequire
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:88:91
匿名函数
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:199249:62
loadModuleImplementation
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:260:13
guardedLoadModule
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:168:37
metroRequire
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:88:91
匿名函数
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:199179:52
loadModuleImplementation
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:260:13
guardedLoadModule
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:168:37
metroRequire
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:88:91
匿名函数
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:1287:47
loadModuleImplementation
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:260:13
guardedLoadModule
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:161:46
metroRequire
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:88:91
全局作用域
    &platform=ios&dev=true&lazy=true&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true&excludeSource=true&sourcePaths=url-server&app=org.reactjs.native.example.OrganizationAppStarter:352097:3

针对性解决方案 #

• 检查原生模块链接状态：
  • iOS：打开ios/Podfile确认是否包含AppAmbitCore相关依赖，执行cd ios && pod install --repo-update重新安装Pods；通过Xcode菜单栏Product > Clean Build Folder清理编译缓存。
  • Android：检查settings.gradle中是否添加了AppAmbitCore模块引用，确认MainApplication.java/MainApplication.kt中是否注册该TurboModule。
• 重置全量缓存：执行npx react-native start --reset-cache清除Metro缓存，删除项目根目录的node_modules和锁文件后重新执行npm install/yarn install。
• 验证模块注册规范：确认AppAmbitCore原生实现是否按TurboModule规范完成注册（iOS需在TurboModuleRegistry中注册，Android需实现TurboModuleProvider并添加模块）。
• 核对模块名称：确保JS代码中调用的AppAmbitCore与原生注册的名称完全一致（大小写敏感）。
• 确认依赖有效性：检查项目是否正确安装了包含AppAmbitCore的依赖包，版本是否与当前React Native版本兼容。

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