You need to enable JavaScript to run this app. Xcode构建React Native iOS应用报Derived Data文件未找到
优惠活动
大模型
产品
解决方案
定价
更多

Xcode构建React Native iOS应用报Derived Data文件未找到

问题本质

你遇到的报错不属于Derived Data缓存损坏类问题,执行清理操作后问题复现也证明了这一点。核心链路是APPTests测试目标在执行ld链接阶段,需要加载主应用的可执行文件作为测试宿主,但因为构建配置错配,主应用的可执行文件没有被正常编译产出,导致链接时找不到对应路径的文件触发失败。

分步排查&修复
  • 检查测试目标的构建依赖绑定
    选中项目导航栏里的iOS项目根节点,切换到APPTests目标,找到Build Phases面板下的Target Dependencies列表,确认是否已经将主应用App目标添加为依赖。如果缺失依赖,Xcode可能会优先调度测试目标的链接流程,此时主应用还未完成编译,自然不会生成对应的可执行文件,触发文件缺失报错。
  • 修正测试目标的硬编码路径配置
    从你提供的日志里能看到路径存在大小写不一致的问题(报错检索路径是/Volumes/Disk/...,实际链接查找路径是/Volumes/DISK/...,Xcode的链接器对磁盘路径、文件名是严格区分大小写的,路径里的大小写不一致会直接判定文件不存在)。这类问题一般是项目迁移、手动修改配置时,把动态取值的配置写成了硬编码路径导致的。
    操作上选中APPTests目标,切换到Build Settings面板,搜索Bundle Loader,确认Debug配置下的取值没有硬编码错误路径,恢复为默认的动态变量格式:$(BUILD_PRODUCTS_DIR)/$(CONTENTS_FOLDER_PATH)/$(EXECUTABLE_NAME);同时检查对应Test Host配置项的取值,确保是动态引用主应用的宿主路径,不要写死老的磁盘路径、项目名路径。
  • 核对主应用的可执行文件配置
    选中主应用目标,在Build Settings里搜索Executable Name,确认Debug-iphonesimulator配置下的取值,和测试目标预期加载的可执行文件名完全一致。如果项目曾做过重命名、团队配置同步不完整,可能出现主应用实际生成的可执行文件名和测试目标要找的文件名不匹配的问题,哪怕文件正常产出,也会因为文件名对不上报找不到。
  • 校验测试Scheme的配置绑定
    点击Xcode顶部的Scheme选择器,选择Edit Scheme,选中左侧菜单的Test环节,确认右侧Info面板下的Executable选项已经正确绑定为主应用目标,没有设置为None或者其他无效目标。如果这里没有绑定测试对应的宿主应用,Xcode在构建时不会触发主应用的编译流程,直接执行测试目标的链接逻辑,必然出现文件缺失的报错。
快速验证方法

暂时关闭Scheme里的Test环节,单独对主应用执行Command+B构建,完成后打开对应Derived Data下的Debug-iphonesimulator目录,检查App.app包内是否存在预期的可执行文件:

  • 如果单独构建主应用时可执行文件可以正常生成,问题100%出在测试目标的依赖、路径配置错配上,按上面的步骤修正即可
  • 如果单独构建主应用时可执行文件也没有生成,就需要回头排查主应用本身的编译流程为什么没有产出可执行文件,常见原因是主应用的Compile Sources环节没有包含核心的入口文件配置

内容的提问来源于stack exchange,提问作者Sven Hager

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 18:27:03