React Native Monorepo安卓端报AppName未注册Metro错误，iOS正常

可能的原因及解决步骤 #

1. 核对安卓端组件名称与JS端注册名称 #

• 打开安卓项目的MainActivity.java（或MainActivity.kt），检查getMainComponentName()方法返回的字符串，必须和index.js中AppRegistry.registerComponent('AppName', () => App)里的AppName完全一致。
• 同时检查AndroidManifest.xml中的android:label属性值，确保和上述名称匹配。

2. 调整Metro配置适配Monorepo #

当前的metro.config.js可能存在路径识别问题，建议修改如下：

const path = require('path');
const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');

const workspaceRoot = path.resolve(__dirname, '../..');
const projectRoot = __dirname;

const config = {
  watchFolders: [workspaceRoot],
  resolver: {
    nodeModulesPaths: [
      path.resolve(projectRoot, 'node_modules'),
      path.resolve(workspaceRoot, 'node_modules'),
    ],
    disableHierarchicalLookup: true,
    sourceExts: ['js', 'jsx', 'json', 'ts', 'tsx', 'android.js'],
  },
};

module.exports = mergeConfig(getDefaultConfig(projectRoot), config);

• 引入@react-native/metro-config的默认配置，避免遗漏必要设置；
• 确保watchFolders包含根目录，让Metro能监听整个Monorepo的文件变化；
• 添加android.js到sourceExts，适配安卓端专属入口文件（如有）。

3. 彻底清除缓存 #

执行以下命令清除所有相关缓存：

# 清除Metro缓存
npx react-native start --reset-cache

# 清除安卓构建缓存
cd android && ./gradlew clean && cd ..

# 重新安装依赖（可选，若依赖存在解析问题）
yarn install # 或 npm install

4. 检查Monorepo依赖配置 #

• 确保根目录的package.json中正确配置workspaces：

{
  "workspaces": [
    "apps/*"
  ]
}

• 确认安卓项目的settings.gradle（或settings.gradle.kts）中正确包含Monorepo依赖引用，避免依赖路径错误。

5. 验证入口文件路径 #

检查MainApplication.java中的getJSMainModuleName()方法返回值为index（对应index.js），如果你的入口文件有其他名称，需同步修改此处。

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