React Native：Podfiles引发模块名称冲突问题求助

我太懂这个坑了！你遇到的这个「Ambiguous resolution」错误，本质就是Metro打包器在找react-native模块时，同时找到了两个合法来源——iOS Pods目录里的React/package.json和项目根目录node_modules/react-native/package.json，它彻底懵了不知道该选哪个。这确实是因为安装react-native-firebase时，Pod会自动拉取React相关依赖到Pods目录，和你项目本身的react-native包撞车了。

下面给你几个靠谱的解决办法，按顺序试就行：

方法1：给Metro指定明确的模块优先级 #

直接修改项目根目录的metro.config.js，告诉Metro优先用你项目node_modules里的react-native，别管Pods里的：

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

const config = {};

module.exports = mergeConfig(getDefaultConfig(__dirname), {
  resolver: {
    // 强制指定react-native模块的路径
    extraNodeModules: {
      'react-native': path.resolve(__dirname, 'node_modules/react-native'),
    },
    // 调整解析优先级，先看react-native字段
    resolverMainFields: ['react-native', 'browser', 'main'],
  },
});

方法2：调整Podfile，避免重复引入React #

别让Pod把整个React都装到Pods目录里，而是直接引用你项目node_modules里的React模块。修改iOS目录下的Podfile：

# 首先给Firebase相关依赖开启模块化头文件（新版react-native-firebase需要）
pod 'Firebase', :modular_headers => true
pod 'FirebaseCore', :modular_headers => true
# 如果你用了其他Firebase组件（比如Auth、Firestore），也给它们加上:modular_headers => true

# 然后注释掉Podfile里可能存在的`pod 'React'`这行，换成按模块引用项目里的React：
pod 'React-Core', :path => '../node_modules/react-native/'
pod 'React-RCTText', :path => '../node_modules/react-native/Libraries/Text'
# 你用到哪些React核心模块就加哪些，比如React-RCTImage、React-RCTNetwork这些

方法3：清理所有缓存，确保配置生效 #

不管改了哪个配置，缓存都是最大的敌人，一定要彻底清一遍：

• 清理Metro缓存：在项目根目录执行 npx react-native start --reset-cache
• 清理Pod依赖：进入iOS目录，执行 pod deintegrate && pod install
• 清理Xcode构建缓存：打开Xcode，点击顶部菜单栏的「Product」→「Clean Build Folder」

额外提醒 #

千万不要手动删Pods/React里的内容！Pod下次执行install时会自动把它拉回来，反而可能引发更多依赖问题。另外要确保你的react-native版本和Pods里的React版本一致，版本不兼容也可能搞出奇怪的问题。如果是React Native 0.70+的版本，推荐用react-native-firebase的自动链接功能，能减少很多手动配置的麻烦。

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