React Native iOS应用出现manifest不存在报错，卡在启动页求助

针对iOS端React Native应用卡在启动页、控制台报manifest does not exist - creating a new one的问题，可按以下步骤排查修复：

• 清除全链路缓存并重建

  1. 重置React Native缓存：执行npx react-native start --reset-cache
  2. 清理iOS依赖与构建缓存：进入项目ios目录，运行pod deintegrate && pod install；打开Xcode按Cmd+Shift+K清理Build Folder
  3. 删除Xcode派生数据：打开Xcode偏好设置→Locations→Derived Data，点击箭头打开文件夹后删除对应项目的全部文件

• 检查Manifest配置文件

  1. 确认项目根目录存在app.json或app.config.js，若缺失，手动创建基础配置：

     {
       "name": "你的应用名称",
       "displayName": "你的应用显示名称"
     }
     

  2. 核对metro.config.js，确保assetExts等配置未错误屏蔽必要资源类型

• 验证iOS项目配置

  1. 打开Xcode的Info.plist，确保CFBundleDisplayName、CFBundleName与app.json中的名称完全一致
  2. 检查AppDelegate.mm（或.swift）的初始化代码，确认moduleName参数与app.json里的name完全匹配，示例Objective-C代码：

     RCTBridge *bridge = [[RCTBridge alloc] initWithDelegate:self launchOptions:launchOptions];
     RCTRootView *rootView = [[RCTRootView alloc] initWithBridge:bridge
                                                     moduleName:@"你的应用名称"
                                              initialProperties:nil];
     

• 排查版本兼容性

  1. 确认React Native、Xcode、CocoaPods版本兼容（比如RN 0.70+要求Xcode 14.1及以上）
  2. 执行npm list react-native查看当前RN版本，对照官方文档确认依赖版本要求

• 重置项目环境
  若以上步骤无效，删除node_modules后重新执行npm install；必要时可删除ios文件夹，重新初始化iOS项目后迁移业务代码

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