iOS React Native静态库与CocoaPods依赖冲突问题求助

这种重复依赖导致的符号冲突确实磨人，我之前帮好几个开发者搞定过类似的坑，给你几个优先级从高到低的可行方案，你可以根据自己的项目情况选：

方案一：统一复用CocoaPods中的React（最推荐，从根源解决） #

既然你已经通过CocoaPods引入了React，完全可以让静态库直接用这个版本，没必要再单独带一份React静态库。步骤如下：

• 先把静态库包里附带的所有React相关静态文件（比如libReact.a、libReact-Core.a这类）全部删掉，确保静态库的工程里彻底没有React的代码或二进制文件。
• 检查你的主项目Podfile，确保React的依赖声明正确，比如：

  pod 'React', :path => '../node_modules/react-native/'
  pod 'React-Core', :path => '../node_modules/react-native/React'
  # 按需添加其他React子模块，比如React-RCTImage、React-RCTText、React-RCTNetwork等
  

• 打开静态库的Xcode target，进入Build Phases → Link Binary With Libraries，移除原来添加的React静态库，转而添加CocoaPods生成的React框架（直接从Xcode左侧的Pods组里找到对应的React模块拖进来就行）。
• 最后给静态库配置头文件搜索路径：在Build Settings → Header Search Paths里添加$(SRCROOT)/../node_modules/react-native/React（路径根据你的项目结构调整），或者用CocoaPods的路径${PODS_ROOT}/Headers/Public/React，确保静态库能找到React的头文件。

方案二：把静态库改成CocoaPods私有库（适合自研静态库） #

如果这个静态库是你们自己开发的，最好把它做成CocoaPods私有库，这样依赖关系交给CocoaPods自动处理：

• 给静态库创建xxx.podspec文件，在里面声明React依赖：

  s.dependency 'React'
  s.dependency 'React-Core'
  # 静态库用到的其他React子模块也加上
  

• 然后在主项目的Podfile里引入这个私有库的pod，CocoaPods会自动保证React只被引入一次，所有依赖都共用同一个版本，彻底避免冲突。

方案三：启用模块化头文件/框架模式（注意兼容性） #

在Podfile开头添加use_modular_headers!（或者use_frameworks!，但后者对RN的兼容性稍差），这样CocoaPods会把所有依赖编译成.framework形式，而不是静态库，能避免静态库和Pods中React的符号冲突。不过要注意：

• 有些老的RN第三方库可能不支持模块化头文件，需要提前测试兼容性。
• 如果用use_frameworks!，可能需要给React单独配置模块化头，比如在Podfile里写：

  pod 'React', :path => '../node_modules/react-native', :modular_headers => true
  

方案四：链接器标记临时解决（应急用，不推荐长期） #

如果上面的方案都暂时没法实施，可以试试在主项目的Build Settings → Other Linker Flags里添加-weak-lReact（或者-force_load，但后者风险更高），强制忽略重复符号。不过这种方法容易引发其他问题，比如某些符号找不到，只能作为临时过渡方案。

总的来说，方案一是最稳妥的，从根源上消除了重复依赖的可能，建议优先尝试。

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