React Native 0.72.3 iOS编译多警告：是否为已知Bug？

一、警告原因 #

1. 文档类警告（libevent等Pods） #

这类属于编译器的文档校验警告，根源是第三方Pod的头文件注释不符合Xcode最新规范：

• -Wdocumentation：注释里用了@param标记参数，但函数声明里找不到对应参数，或者参数名不匹配
• -Wdocumentation-deprecated-sync：注释里标了@deprecated（废弃），但代码里没加__attribute__((deprecated))这类编译级别的废弃属性

这些是第三方依赖自身的问题，和RN框架无关。

2. Folly重复符号警告 #

Folly是RN底层依赖的C++工具库，重复符号问题主要因为：

• 多个第三方依赖同时引入了不同版本的Folly，或者重复编译了同一模块
• RN 0.72.x升级了Folly版本，部分社区插件还没完成适配，导致依赖冲突，链接时出现符号重复

二、是否为已知Bug #

都是RN 0.72.x版本的已知问题：

• 文档类警告：RN官方仓库的Issues里有很多用户反馈类似情况，属于依赖库自身迭代滞后，不是RN的Bug，但RN默认没屏蔽这类警告
• Folly重复符号：RN 0.72.x的Folly版本升级后，大量社区插件未及时适配，导致依赖冲突，这个问题在RN社区论坛和GitHub Issues里有广泛讨论，属于版本适配阶段的常见问题

三、修复方案 #

1. 屏蔽文档类警告 #

在iOS项目的Podfile中添加以下代码，给特定Pods关闭文档相关警告：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    # 给libevent关闭文档警告
    if target.name == 'libevent'
      target.build_configurations.each do |config|
        config.build_settings['WARNING_CFLAGS'] ||= []
        config.build_settings['WARNING_CFLAGS'] << '-Wno-documentation'
        config.build_settings['WARNING_CFLAGS'] << '-Wno-documentation-deprecated-sync'
      end
    end
    # 其他报同类警告的Pods，复制上述逻辑添加即可
  end
end

修改后执行pod install生效。

2. 解决Folly重复符号问题 #

• 排查并升级第三方插件：找出项目中依赖Folly的社区插件，优先升级到适配RN 0.72.x的版本
• 锁定Folly版本：在Podfile里添加以下代码，强制所有依赖使用RN自带的Folly版本：

pod 'RCT-Folly', :podspec => '../node_modules/react-native/third-party-podspecs/RCT-Folly.podspec', :modular_headers => true
pod 'RCT-Folly/Futures', :podspec => '../node_modules/react-native/third-party-podspecs/RCT-Folly.podspec', :modular_headers => true

执行pod install --repo-update完成依赖同步

• 彻底清理编译产物：除了pod deintegrate && pod install，还要手动删除ios/build目录，以及Xcode的Derived Data（路径：Xcode -> 设置 -> 位置 -> Derived Data -> 打开文件夹删除对应项目的目录）

四、是否需要担忧 #

• 文档类警告：完全不影响应用功能和稳定性，只是注释不规范，屏蔽后即可消除，无需担心
• Folly重复符号警告：目前能正常编译运行说明只是警告级别的冲突，但后续添加新依赖或升级RN时，可能会触发链接错误导致编译失败，建议尽早修复，避免后续出问题

内容的提问来源于stack exchange，提问作者Mike S.