React Native iOS构建报错：'RCTAppDelegate.h'文件未找到求助

云上老周

2026-7-17

React Native v0.71.7 iOS构建报错：'RCTAppDelegate.h' file not found 解决方案

问题背景

React Native v0.71.7项目Android端运行正常，但iOS端构建失败，报错：

..../AppDelegate.h:1:9: fatal error: 'RCTAppDelegate.h' file not found

项目由M1 Mac创建，当前使用Intel Mac开发，已尝试修改Xcode排除架构、通过Gem重装CocoaPods、删除Pods/Podfile.lock重建Podfile并执行pod install、删除node_modules等操作，使用pnpm作为包管理器。

AppDelegate.h内容如下：

#import <RCTAppDelegate.h>
#import <UIKit/UIKit.h>

@interface AppDelegate : RCTAppDelegate

@end

RCTAppDelegate是React Native官方提供的预封装AppDelegate基类，已内置RN初始化、JS Bundle加载、原生与RN通信基础逻辑（如启动参数处理、根视图设置、生命周期回调等），无需开发者从零编写这些重复核心代码。

你的AppDelegate继承自RCTAppDelegate，Objective-C语法要求必须先导入父类头文件，才能识别父类的方法、属性并完成继承，否则编译器会报错。

结合M1/Intel架构差异及你的操作，主要诱因包括：

架构差异导致依赖安装异常：M1默认arm64架构，Intel为x86_64，CocoaPods在不同架构下对RN核心依赖的路径处理不一致，导致RCTAppDelegate所在的React-Core模块未被正确引入Xcode项目。
pnpm依赖管理的路径解析问题：pnpm通过硬/软链接管理依赖，相比npm/yarn，可能导致CocoaPods解析RN核心依赖路径时出现偏差，Xcode无法找到头文件。
Podfile配置或缓存残留：虽重建了Podfile，但可能配置未正确引入RN核心specs，或Xcode DerivedData缓存未彻底清理，导致头文件索引失败。

不建议直接移除：移除后需手动实现所有RN初始化核心逻辑，对RN原生层不熟悉的开发者极易出错。优先尝试以下标准修复步骤：

彻底清理依赖与缓存

进入iOS目录清理Pod相关文件与Xcode缓存：

cd ios
rm -rf Pods Podfile.lock
rm -rf ~/Library/Developer/Xcode/DerivedData

重新生成标准Podfile（若原有Podfile存在配置问题）：

npx react-native init TempProject --version 0.71.7
cp TempProject/ios/Podfile 你的项目路径/ios/
rm -rf TempProject

检查Xcode头文件搜索路径
- 打开Xcode项目的.xcworkspace文件，选择主Target进入Build Settings
- 搜索Header Search Paths，确保添加以下递归路径（若不存在则新增）：
```
$(SRCROOT)/Pods/Headers/Public/React-Core
$(SRCROOT)/../node_modules/react-native/React
```
临时备选：修改导入路径
若上述方法无效，可临时将尖括号导入改为相对路径导入（指向node_modules中的RN核心头文件）：
```
#import "../node_modules/react-native/React/RCTAppDelegate.h"
#import <UIKit/UIKit.h>

@interface AppDelegate : RCTAppDelegate

@end
```
注：此为临时方案，后续版本升级需调整路径，优先使用标准修复方案。
验证RN核心依赖完整性
检查node_modules/react-native/React/RCTAppDelegate.h文件是否存在，若不存在则重新安装RN依赖：
```
pnpm add react-native@0.71.7 --save-exact
```

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