Xcode报RevenueCat-Swift.h未找到无法构建RevenueCat模块如何解决

这个报错是Xcode 14.3及以上版本的编译调度bug触发的：归档走Release配置时默认开启最高优先级并行编译，Clang解析RevenueCat的modulemap文件时，Swift代码还没完成编译生成对应的RevenueCat-Swift.h桥接头文件，直接触发头文件找不到的错误；普通Debug构建编译压力小，重试时头文件刚好生成完成，所以会出现重试1-2次就正常、归档100%失败的表现，和RevenueCat本身的代码逻辑无关。

方案1：修正modulemap头文件路径（根治归档报错，适配所有集成方式） #

你当前用的modulemap里对Swift桥接头的引用是相对路径，Xcode新版本在Release归档阶段不会自动把Swift生成头的目录加入头文件搜索路径，直接替换modulemap里的Swift子模块配置，用构建变量指定绝对路径，同时强制依赖编译顺序：

framework module RevenueCat {
  umbrella header "RevenueCat-umbrella.h"

  export *
  module * { export * }
}

module RevenueCat.Swift {
    header "${BUILT_PRODUCTS_DIR}/RevenueCat.framework/Headers/RevenueCat-Swift.h"
    requires objc
}

如果是CocoaPods集成，不要直接修改Pods目录下的文件（下次pod install会被覆盖），直接在Podfile最末尾加如下post_install脚本，每次执行pod install时自动修正路径：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    next unless target.name == 'RevenueCat'
    modulemap_path = File.join(target.build_configurations.first.build_settings['PODS_TARGET_SRCROOT'], 'Target Support Files', 'RevenueCat', 'RevenueCat.modulemap')
    next unless File.exist?(modulemap_path)
    content = File.read(modulemap_path)
    new_content = content.gsub('header "RevenueCat-Swift.h"', 'header "${BUILT_PRODUCTS_DIR}/RevenueCat.framework/Headers/RevenueCat-Swift.h"')
    File.write(modulemap_path, new_content)
  end
end

加完执行pod install，按Shift+Command+K清理构建缓存后再归档即可。

方案2：调整编译配置（无需修改第三方文件，适合SPM集成场景） #

如果是用Swift Package Manager集成的RevenueCat，不想手动修改modulemap，直接调整编译配置绕开Xcode的并行编译bug：

• 打开项目设置，选中你的应用Target，进入Build Phases页签
• 在Target Dependencies里显式添加RevenueCat依赖，确保RevenueCat的编译优先级高于业务代码
• 进入Build Settings页签，搜索Parallelize Build，将Release配置下的该选项设置为No
• 继续搜索Other Swift Flags，给Release配置添加-no-verify-emitted-module-interface标记
  这个方案会小幅增加Release归档的编译时长，但不需要改动第三方依赖的文件，稳定性足够。

方案3：清理全量构建缓存（解决缓存残留导致的偶发报错） #

如果上述配置改完仍有偶发报错，是Xcode更新后旧版本的编译缓存残留导致的，按如下步骤清理：

1. 完全退出Xcode
2. 终端执行命令删除派生数据：rm -rf ~/Library/Developer/Xcode/DerivedData/*
3. SPM集成的用户额外执行命令删除包缓存：rm -rf ~/Library/Caches/org.swift.swiftpm/*
4. 重启Xcode，等待依赖重新解析完成后再执行构建/归档

注意：不需要盲目升级RevenueCat版本尝试修复，该问题完全是Xcode新版本的编译调度逻辑变更导致，和RevenueCat版本无直接关联，盲目升级反而可能触发新的API适配问题。

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