新增Production-Debug构建配置后iOS项目构建报错：FirebaseCoreInternal.modulemap文件未找到

看起来你在新增自定义的Production-Debug构建配置后，踩中了CocoaPods和Firebase依赖的坑——这种自定义配置的不兼容问题我之前也遇到过好几次，咱们一步步拆解解决：

问题根源分析 #

你的三个默认配置（Debug/Release-Staging/Release）能正常工作，是因为CocoaPods默认识别这些标准配置并自动生成对应的构建产物路径。但你复制Debug配置创建的Production-Debug属于自定义配置，CocoaPods不会自动适配，加上你修改了部分生产级的构建设置，导致Firebase这类依赖模块化头文件的库，找不到对应配置下生成的modulemap文件。另外react-native-config的环境变量加载和Schema的配置映射不匹配，也会加剧这个问题。

具体解决步骤 #

1. 让CocoaPods正确识别自定义Production-Debug配置 #

CocoaPods对配置名称的大小写、拼写极其敏感，首先要确保Xcode里的配置名称完全一致，然后执行带配置参数的pod install，强制让CocoaPods为新配置生成对应产物：

# 替换为你Production-Debug对应的.env文件，比如.env.production-debug
ENVFILE=.env.production-debug pod install --configuration=Production-Debug

2. 调整Podfile适配自定义配置 #

你的Podfile里已经有静态框架和Firebase的设置，但需要确保覆盖所有配置，尤其是自定义的Production-Debug：
修改Podfile的target块，补充以下内容：

target 'TinyPal' do
  use_frameworks! :linkage => :static
  $RNFirebaseAsStaticFramework = true
  config = use_native_modules!

  # 确保react-native-config在所有配置下正常加载
  pod 'react-native-config', :path => '../node_modules/react-native-config'
  pod 'react-native-config/Extension', :path => '../node_modules/react-native-config'

  # 显式指定Firebase系列依赖的模块化头文件对所有配置生效
  pod 'FirebaseCoreInternal', :modular_headers => true
  pod 'FirebaseCore', :modular_headers => true
  pod 'FirebaseAnalytics', :modular_headers => true
  pod 'FirebaseInstallations', :modular_headers => true
  # 其他Firebase依赖同理添加

  # 保留你原有的pre_install钩子，补充Firebase的静态框架强制设置
  pre_install do |installer|
    installer.pod_targets.each do |pod|
      if pod.name.start_with?('Firebase') || pod.name.start_with?('MoE') || pod.name.start_with?('ReactNativeMoEngage')
        def pod.build_type; Pod::BuildType.static_library end
      end
    end
  end

  # 其他原有代码...
end

3. 彻底清理构建缓存（关键！） #

普通的Xcode Clean不足以解决缓存问题，要彻底删除派生数据和Pod缓存：

1. Xcode中按Cmd+Shift+K清理当前构建
2. 打开Finder，按Cmd+Shift+G，输入~/Library/Developer/Xcode/DerivedData，找到你的项目对应文件夹（报错里的TinyPal-cxlfkymbkbwwahgxqyvljgfqwyev），直接删除
3. 清理Pod的全局缓存和本地集成：

pod deintegrate
pod cache clean --all

清理完成后，重新执行步骤1的带配置参数的pod install

4. 修复Schema与Production-Debug的映射问题 #

你提到选Production Schema+Debug配置时，appIcons和branch.io keys还是Staging的，这是因为Schema的环境变量和资源配置没关联到新配置：

1. Xcode顶部菜单栏点击Product > Scheme > Edit Scheme
2. 选中Run标签，切换到Info页，确保Build Configuration选择的是Production-Debug
3. 切换到Arguments页，在Environment Variables里添加ENVFILE，值为你的Production-Debug对应的.env文件（比如.env.production-debug）
4. 检查Xcode的Build Settings中，Production-Debug配置下的GCC_PREPROCESSOR_DEFINITIONS，确保包含REACT_NATIVE_CONFIG_ENV=production-debug（对应你的环境名称）

5. 验证Pod构建产物路径 #

如果还是报错，检查DerivedData的Production-Debug-iphoneos路径下，是否存在FirebaseCoreInternal文件夹：

• 如果不存在，说明CocoaPods没为该配置生成产物，删除Podfile.lock后重新执行带配置的pod install：

rm Podfile.lock
ENVFILE=.env.production-debug pod install --configuration=Production-Debug

额外注意事项 #

• 自定义配置名称尽量避免和标准配置混淆（比如不要用奇怪的拼写），CocoaPods对命名的一致性要求很高
• 每次修改Podfile或新增配置后，必须带对应配置参数执行pod install，否则CocoaPods只会生成默认配置的产物
• Xcode 14+用户要确保Production-Debug配置下的Build Active Architecture Only设置为YES（Debug模式的常规设置），避免构建多余架构导致路径混乱

内容来源于stack exchange