解决 RN Archive Multiple commands produce privacy bundle 报错

搞定 React Native Archive 报错：Multiple Commands Produce Privacy Bundle 问题详解

开发 React Native 应用，用 Xcode Archive 打包准备上架时，有时会碰到一个看着头疼的报错：Multiple commands produce ... React-Core_privacy.bundle 或 RCT-Folly_privacy.bundle。就像下面这样：

Multiple commands produce '/Users/用户名/Library/Developer/Xcode/DerivedData/项目名-xxxxx/Build/Intermediates.noindex/ArchiveIntermediates/项目名/IntermediateBuildFilesPath/UninstalledProducts/iphoneos/React-Core_privacy.bundle'

Target 'React-Core-xxxx-React-Core_privacy' (project 'Pods') has create directory command with output ... React-Core_privacy.bundle'
Target 'React-Core-React-Core_privacy' (project 'Pods') has create directory command with output ... React-Core_privacy.bundle'

Multiple commands produce '/Users/用户名/Library/Developer/Xcode/DerivedData/项目名-xxxxx/Build/Intermediates.noindex/ArchiveIntermediates/项目名/IntermediateBuildFilesPath/UninstalledProducts/iphoneos/RCT-Folly_privacy.bundle'

Target 'RCT-Folly-RCT-Folly_privacy' (project 'Pods') has create directory command with output ... RCT-Folly_privacy.bundle'
Target 'RCT-Folly.default-Fabric-RCT-Folly_privacy' (project 'Pods') has create directory command with output ... RCT-Folly_privacy.bundle'

这个错误信息的意思是，在你的 Xcode 项目（特别是 Pods 子项目）里，有两个或更多的 "Target" （编译目标）都试图在同一个位置创建同一个文件或目录（这里是 React-Core_privacy.bundle 和 RCT-Folly_privacy.bundle）。这通常发生在 React Native 0.73 版本及以后，特别是配合 Xcode 15 或更高版本（问题中提到了 RN 0.77.0 和 Xcode 16.2）。Build (编译) 可能没问题，但 Archive (归档) 环节就卡壳了。

问题根源在哪儿？

这事的根儿主要在 CocoaPods 和 React Native 对苹果隐私清单 (Privacy Manifest) 的支持方式 上。

1. 隐私清单 (PrivacyInfo.xcprivacy) ：苹果要求 App 提供隐私清单文件，说明数据使用情况。React Native 0.73+ 版本开始在其核心库 (React-Core, RCT-Folly 等) 中包含了这些清单文件。
2. 打包成 .bundle ：为了方便集成，RN (通过 CocoaPods 的 Podspec 文件配置) 会把这些 .xcprivacy 文件打包成 .bundle 格式，比如 React-Core_privacy.bundle。这个打包动作通常是在 Xcode 的 Build Phases (构建阶段) 里通过脚本或者 "Copy Files" 步骤完成的。
3. CocoaPods 的 Target 生成逻辑 ：CocoaPods 会根据你的 Podfile 配置（比如是否启用 Fabric、是否使用 use_frameworks! 等）以及各个 Pod 库自身的 Podspec 文件，来生成 Pods 项目里的各种 Targets。
4. 冲突发生 ：在某些特定配置下（可能是 RN 版本升级、CocoaPods 版本、或者项目特定设置的组合拳），CocoaPods 可能为同一个 Pod 库（如 React-Core 或 RCT-Folly）生成了 多个 相关的 Target，或者配置了 多个 Build Phase，它们最终都指向了同一个目标——创建那个 _privacy.bundle。错误日志里的 Target 名字差异 (例如 React-Core-xxxx-React-Core_privacy vs React-Core-React-Core_privacy) 就暗示了这种重复或冲突。Xcode 在执行 Archive 时发现“这活儿好几个人抢着干，还都想把结果放同一个地方”，就懵了，于是报错。

动手解决：方案来了

碰到这问题别慌，试试下面这几招，总有一款适合你。

方案一：清理大法好

老生常谈但有时确实管用。旧的构建缓存或配置可能导致各种奇怪问题。

1. 原理和作用 : 清理掉 Xcode 和 CocoaPods 可能遗留的旧缓存和中间文件，让一切从“干净”的状态重新开始。
2. 操作步骤 :
   • Xcode 清理 :
     • 在 Xcode 里，选择菜单 Product -> Clean Build Folder (快捷键 Cmd+Shift+K)。
   • 删除 DerivedData :
     • 关掉 Xcode。
     • 打开终端 (Terminal)。
     • 运行命令删除整个 DerivedData 目录（Xcode 会自动重建）：

       rm -rf ~/Library/Developer/Xcode/DerivedData/
       

       注意：这会清空所有项目的构建缓存，下次打开项目需要重新编译，可能会慢一点。
   • CocoaPods 清理与重装 :
     • 在你的项目 ios 目录下，打开终端。
     • 彻底解除 Pods 集成：

       pod deintegrate
       

     • 删除 Pods 目录和 Podfile.lock 文件（可选但推荐）：

       rm -rf Pods Podfile.lock
       

     • 重新安装 Pods：

       pod install --repo-update # 加上 --repo-update 确保你的 Podspec 仓库是最新的
       # 或者如果你不需要更新仓库，直接用:
       # pod install
       

   • 重启大法 ：有时简单重启一下 Mac 也有奇效（虽然听起来玄学）。
3. 重新尝试 Archive : 打开 .xcworkspace 文件，再次尝试 Archive (Product -> Archive)。

安全建议 : 执行 rm -rf 命令要小心，确认路径没搞错。pod deintegrate 会移除 Pods 对你主项目的配置，pod install 会重新加回来，一般是安全的，但以防万一，可以先备份一下你的 .xcodeproj 和 Podfile 文件。

方案二：检查和更新 CocoaPods 版本

CocoaPods 本身也在不断迭代，旧版本可能有 Bug，新版本可能修复了这类 Target 生成问题。

1. 原理和作用 : 特定版本的 CocoaPods 可能存在 Target 生成的逻辑缺陷，导致了重复。更新到最新稳定版或者有时回退到一个已知的“好”版本可能解决问题。
2. 操作步骤 :
   • 检查当前 CocoaPods 版本：

     pod --version
     

   • 更新 CocoaPods 到最新版（如果需要管理员权限，前面加 sudo）：

     sudo gem install cocoapods
     

   • 或者安装指定版本（比如你想回退到 1.14.3）：

     sudo gem install cocoapods -v 1.14.3
     

   • 更新/安装完后，回到你的项目 ios 目录，重新运行：

     pod install
     

3. 重新尝试 Archive : 再次尝试 Xcode Archive。

安全建议 : 更新/降级 CocoaPods 版本可能影响依赖解析，确保 pod install 成功并且你的项目还能正常编译运行。最好在版本控制 (如 Git) 中记录这次变更。

方案三：Podfile 精准动刀 (post_install Hook)

这是针对这类问题最常见且有效的“手术刀”疗法。我们在 Podfile 里加一段脚本，在 CocoaPods 安装完依赖、准备生成 Xcode 项目文件 之后，介入修改一下，把重复的构建指令去掉。

1. 原理和作用 : 利用 CocoaPods 提供的 post_install 钩子，访问到即将生成的 Pods 项目结构（installer.pods_project），找到那些导致冲突的 Targets，然后精确地移除掉其中一个 Target 里面负责创建 _privacy.bundle 的那个 Build Phase（构建阶段）。这样，每个 .bundle 文件就只有一个 Target 会去创建它了。

2. 操作步骤 :

   • 打开你项目根目录下的 ios/Podfile 文件。
   • 在文件的末尾（但在最后的 end 之前），添加类似下面的 Ruby 代码块：

   post_install do |installer|
     installer.pods_project.targets.each do |target|
       # 定位可能产生冲突的 Build Phase (通常是脚本或Copy Files阶段)
       target.build_phases.each do |phase|
         # 检查这个 Build Phase 的输出文件路径是否包含我们要处理的 privacy bundle
         next unless phase.respond_to?(:output_paths) && phase.output_paths
   
         conflicting_output = phase.output_paths.find do |path|
           path.include?('React-Core_privacy.bundle') || path.include?('RCT-Folly_privacy.bundle')
         end
   
         # 如果找到了产生冲突 bundle 输出的 Build Phase
         if conflicting_output
           bundle_name = conflicting_output.split('/').last # 获取 bundle 文件名
           target_name = target.name # 获取当前 Target 的名字
   
           # 根据错误日志，决定哪个 Target 应该 *保留* 这个 Build Phase
           # 其他命名模式的 Target 则需要移除这个 Phase
           # 注意: 这里的判断逻辑需要根据你实际收到的错误信息来精确调整！
           # 错误信息里通常会给出两个冲突 Target 的名字，选一个你认为“主”的保留。
           # 例如，错误说 'React-Core-xxxx-...' 和 'React-Core-React-Core_privacy' 冲突
           # 我们可能选择保留 'React-Core-React-Core_privacy' 这个 Target 的 Phase
   
           keep_target_prefix = nil
           case bundle_name
           when "React-Core_privacy.bundle"
             # 假设我们决定保留名字是 "React-Core-React-Core_privacy" 的 Target 的 Phase
             keep_target_prefix = "React-Core-React-Core_privacy"
           when "RCT-Folly_privacy.bundle"
             # 假设我们决定保留名字是 "RCT-Folly-RCT-Folly_privacy" 的 Target 的 Phase
             keep_target_prefix = "RCT-Folly-RCT-Folly_privacy"
           end
   
           # 如果当前 Target 的名字 *不是* 我们指定要保留的那个，
           # 并且看起来确实是冲突错误信息里提到的那种命名模式（例如，带有一长串哈希值或者 '.default-Fabric'）
           # 那么就移除这个 Build Phase
           if keep_target_prefix && !target_name.start_with?(keep_target_prefix)
             is_potential_duplicate = false
             # 再加一层检查，确保我们只动那些看起来像“副本”的 Target
             # 这个判断逻辑可能需要根据你的具体错误信息微调
             if bundle_name == "React-Core_privacy.bundle" && target_name.start_with?("React-Core-") && target_name != keep_target_prefix
               is_potential_duplicate = true
             elsif bundle_name == "RCT-Folly_privacy.bundle" && target_name.start_with?("RCT-Folly-") && target_name != keep_target_prefix
               is_potential_duplicate = true
             end
   
             if is_potential_duplicate
               puts "[Podfile Hook] 发现潜在冲突: Target '#{target.name}' 也在尝试生成 '#{bundle_name}'。正在移除其相关构建阶段..."
               target.build_phases.delete(phase)
               puts "[Podfile Hook] 已移除 Target '#{target.name}' 的冲突构建阶段。"
               # 移除了这个 Target 的冲突 Phase 后，就不用再检查这个 Target 的其他 Phase 了，处理下一个 Target
               break 
             end
           end
         end
       end
     end
   end
   

   • 保存 Podfile。
   • 回到终端，在 ios 目录下，重新运行 pod install：

     pod install
     

     你应该能在终端输出里看到类似 [Podfile Hook] ... 的信息，说明脚本被执行了。
   • 重新打开 Xcode 的 .xcworkspace 文件，然后再次尝试 Archive。

3. 安全建议 :

   • 这个 post_install Hook 是对 Pods 项目内部结构的修改。确保你的判断逻辑（哪个 Target 保留，哪个 Target 移除 Phase）是根据你收到的 具体错误信息 来定制的。上面代码里的 keep_target_prefix 的设定只是一个 例子，你需要根据自己的错误日志来确定。
   • 每次 React Native、CocoaPods 或相关 Pod 库升级后，这个 Hook 可能需要调整或可能不再需要。
   • 在应用此 Hook 前，最好用 Git 等版本控制工具提交当前状态，方便回滚。

4. 进阶使用技巧 :

   • 如何确定是哪个 Build Phase ？ 如果不确定是哪个 Build Phase 导致的问题（比如它没名字），可以在 post_install Hook 里打印更多信息来调试，例如 puts phase.inspect。或者，可以在 pod install 后，手动打开 Pods/Pods.xcodeproj，找到报错信息里提到的 Target，检查其 "Build Phases" 页签，看看哪个 "Run Script" 或 "Copy Files" 阶段看起来与创建 _privacy.bundle 有关，记下它的名字或特征，然后在 Hook 脚本里精确匹配它。
   • 理解 installer.pods_project : 这是 CocoaPods 提供的一个 Xcodeproj 对象，你可以用它来访问和修改 Pods 项目的 Targets, Build Phases, Build Settings 等。详情可以查阅 CocoaPods Guides 或 xcodeproj Ruby gem 的文档。

方案四：手动调整 Xcode Build Phases (非常不推荐！)

最后一种方法是直接在 Xcode 里修改 Pods.xcodeproj。

1. 原理和作用 : 和方案三类似，但你是用图形界面手动操作，找到冲突的 Target 和 Build Phase，然后删掉多余的那个。
2. 操作步骤 :
   • 在 Xcode 中打开你的 .xcworkspace 文件。
   • 在左侧导航栏找到 Pods 项目。
   • 展开 Pods 项目，找到报错信息中提到的那几个冲突的 Targets (例如 React-Core-xxxx-... 和 React-Core-React-Core_privacy)。
   • 选中其中一个你认为是“多余”的 Target (通常是名字看起来更复杂或带有哈希值的那个)。
   • 点击顶部的 Build Phases 标签页。
   • 仔细查找列表中的各个阶段，找到那个负责创建/拷贝 _privacy.bundle 的阶段（可能名字是 "Copy Bundle Resources", "Run Script", 或者其他相关的）。
   • 选中这个阶段，然后点列表下方的小 - 号按钮将其删除。
   • 对 RCT-Folly 相关的冲突 Targets 重复此操作。
   • 然后尝试 Archive。
3. 严重警告 : 极不推荐 这样做！因为你对 Pods.xcodeproj 的任何手动修改，在下一次运行 pod install 或 pod update 时， 都 会 被 覆 盖 掉 ！这意味着问题会再次出现。这种方法最多只能用来临时验证一下删除某个 Build Phase 是否能解决问题，不能作为长期方案。

防患于未然 & 一点思考

• 保持更新 : 尽量让你的 React Native, CocoaPods, Node.js, Xcode 保持在相互兼容的较新版本，社区可能已经在新版本中解决了这些集成问题。
• 理解你的 Podfile : 知道 Podfile 里的各项配置（如 use_frameworks!, config.build_settings, :fabric_enabled）可能带来的影响。
• 版本控制是朋友 : 把 Podfile 和 Podfile.lock 都纳入版本控制。Podfile.lock 锁定了你当前使用的各个 Pod 库的具体版本，有助于保持环境一致性，减少因库版本变动引入的问题。
• 定期清理 : 偶尔执行一下方案一的清理步骤，可以预防一些奇怪的缓存问题。

这个问题本质上是构建系统配置层面的冲突，通常不是你代码本身的问题。通过理解原因，并选用合适的解决方案（强烈推荐 post_install Hook 的方式），你应该能顺利解决这个 Archive 拦路虎。

相关资源 (可选)

查找类似问题时，可以关注以下地方：

• React Native GitHub Issues: https://github.com/facebook/react-native/issues (搜索 "Multiple commands produce privacy bundle")
• CocoaPods GitHub Issues: https://github.com/CocoaPods/CocoaPods/issues
• Stack Overflow (搜索类似错误信息)