GitHub Actions中Xcode 15.2构建React Native iOS项目时Firebase Pods出现Swift语法错误

阿华AIGC实验室

2026-4-7

问题原因分析

你看到的这些Swift语法错误，核心是FirebaseSharedSwift的版本与Xcode15.2的编译环境要求不兼容，具体有两个关键诱因：

Swift版本与语法的冲突：你碰到的nonisolated(unsafe)、sending都是Swift 5.7及以上版本才支持的语法（Xcode15.2默认用Swift 5.9）。但因为部分Pods还设置了iOS 9/10的旧部署目标，Xcode在编译时会强制切换到更低的Swift语言版本模式来兼容旧目标，导致新语法被当成错误解析。
Xcode15.2的部署目标限制：Xcode15.2彻底放弃了对iOS 9/10的支持，当项目里还有Pods保留这些旧目标时，整个编译环境会出现冲突——哪怕是Pod自身的代码，也会因为Xcode的强制兼容逻辑出现语法解析异常。

有没有其他开发者遇到过？

当然有！不少开发者在升级到Xcode15系列后，配合旧Firebase版本或低部署目标的Pods时，都碰到过FirebaseSharedSwift的类似错误。尤其是Firebase 10.x版本开始大量使用Swift 5.7+的语法，一旦编译环境因为部署目标被限制，就会触发这类报错。

解决方案

结合你的尝试和问题根源，按以下步骤调整应该能解决问题：

1. 统一所有Pods的iOS部署目标到12.0+

Xcode15.2最低要求iOS12.0，必须把所有Pods的部署目标都提到这个版本以上。修改你的Podfile的post_install钩子，强制覆盖所有target的配置：

post_install do |installer|
  react_native_post_install(
    installer,
    config[:reactNativePath],
    :mac_catalyst_enabled => false,
  )
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      # 强制所有Pods使用iOS12.0作为部署目标
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0'
      # 明确指定Swift版本为5.9（匹配Xcode15.2）
      config.build_settings['SWIFT_VERSION'] = '5.9'
    end
  end
end

2. 升级Firebase相关Pods到兼容Xcode15的版本

确保你的Firebase iOS SDK版本在10.12.0及以上（这个版本开始全面适配Xcode15）。你的@react-native-firebase/*包是22.4.0，对应的Firebase iOS版本应该是兼容的，但可以在Podfile里明确锁定兼容版本避免歧义：

pod 'Firebase/Analytics', '~> 10.18.0'
pod 'Firebase/Auth', '~> 10.18.0'
pod 'Firebase/Database', '~> 10.18.0'
pod 'Firebase/Firestore', '~> 10.18.0'
pod 'Firebase/Messaging', '~> 10.18.0'

3. 调整GitHub Actions的编译环境

确保你的Workflow使用支持Xcode15.2的镜像，并明确指定Xcode版本：

jobs:
  ios-build:
    runs-on: macos-14 # 或macos-13，这两个镜像预装Xcode15.2
    steps:
      - name: 切换到Xcode15.2
        run: sudo xcode-select -s /Applications/Xcode_15.2.app/Contents/Developer
      - name: 清理缓存与Pods
        run: |
          rm -rf Pods/ Podfile.lock
          xcodebuild clean -all
          pod cache clean --all
      - name: 安装依赖
        run: pod install --repo-update
      # 后续的构建步骤...