React Native中'React/RCTImageLoader.h'文件未找到问题求助

问题根源 #

Xcode14.2对React Native旧版本的头文件引用逻辑做了调整，加上M1芯片的架构兼容问题，导致第三方依赖（比如react-native-fs）无法正确定位React核心头文件，触发这个编译错误。

分步解决办法 #

1. 先确认React Native版本兼容性 #

Xcode14.2要求React Native版本至少为0.70以上，如果你的项目版本低于这个，优先升级：

# 升级到最新稳定版，或指定0.70+版本
npx react-native upgrade

如果暂时不想升级，继续往下操作。

2. 修复Podfile配置 #

编辑ios目录下的Podfile，在文件末尾添加以下配置（注意放在target '你的项目名' do ... end之后）：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    # 单独修复react-native-fs的头文件路径
    if target.name == "react-native-fs"
      target.build_configurations.each do |config|
        config.build_settings["HEADER_SEARCH_PATHS"] = "$(inherited) $(SRCROOT)/../node_modules/react-native/React/**"
      end
    end
    # 统一修复React核心模块的构建配置
    if target.name.start_with?('React') || target.name.start_with?('RCT')
      target.build_configurations.each do |config|
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
      end
    end
  end
end

3. 彻底清理并重新安装依赖 #

执行以下命令，清空所有旧缓存和依赖：

# 清理Xcode构建缓存
xcodebuild clean -project ios/你的项目名.xcodeproj -configuration Debug -alltargets

# 卸载现有Pods
pod deintegrate

# 针对M1架构重新安装Pods
arch -x86_64 pod install

# 清理node_modules和锁文件
rm -rf node_modules package-lock.json yarn.lock
npm install

4. 永久修复react-native-fs的导入问题（避免修改node_modules） #

直接改node_modules里的文件会被覆盖，用patch-package做永久修改：

1. 安装补丁工具：

npm install patch-package --save-dev

2. 修改node_modules/react-native-fs/RNFSManager.m的导入代码为：

#if __has_include("RCTImageLoader.h")
#import "RCTImageLoader.h"
#else
#import <React/RCTImageLoader.h>
#endif

3. 生成补丁文件：

npx patch-package react-native-fs

之后每次执行npm install，补丁会自动应用。

5. Xcode最终配置检查 #

打开Xcode，选中项目根目标，进入Build Settings：

• 确保Header Search Paths添加了$(SRCROOT)/../node_modules/react-native/React，并勾选Recursive
• 确保Framework Search Paths添加了$(SRCROOT)/../node_modules/react-native/ReactCommon/turbomodule/core，勾选Recursive
• 将Build Active Architecture Only的Debug和Release选项都设为NO

验证运行 #

完成所有步骤后，先在Xcode中选择iOS 16+的模拟器，点击Build运行；或者执行：

npx react-native run-ios

内容的提问来源于stack exchange，提问作者Shaik Sai Farook