使用EAS构建iOS Expo应用时遇Firebase相关Swift Pods错误求助

错误原因 #

这个报错的核心问题是：FirebaseCoreInternal这类Swift编写的Pod依赖了GoogleUtilities，但GoogleUtilities默认没有生成模块映射文件。当iOS构建使用静态库模式时，Swift无法导入没有模块化头文件的依赖，从而触发冲突。

解决方法 #

因为Expo项目无法直接修改原生Podfile，需要通过Expo配置文件来设置Pod属性，有两种方案可选：

方案1：全局启用模块化头文件

在项目的app.json或app.config.js中添加以下配置，让所有Pods都生成模块化头文件：

{
  "expo": {
    "ios": {
      "podfileProperties": {
        "use_modular_headers": true
      }
    }
  }
}

方案2：仅针对特定依赖启用（更轻量化）

如果不想全局修改，只给GoogleUtilities单独开启模块化头文件，配置如下：

{
  "expo": {
    "ios": {
      "podfileProperties": {
        "perPodPodfileProperties": {
          "GoogleUtilities": {
            "modular_headers": true
          }
        }
      }
    }
  }
}

后续操作 #

修改完配置后，重新执行iOS构建命令：

eas build --platform ios

如果之前有构建缓存导致配置不生效，可添加清理缓存参数：

eas build --platform ios --clear-cache

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