Expo SDK 48 iOS端Fastlane构建失败求助

云原生阿岚

2026-7-3

解决托管式Expo iOS构建Fastlane阶段FBReactNativeSpec脚本执行失败问题

问题概述

基于托管式Expo构建iOS应用时，Fastlane归档阶段失败，核心错误提示为PhaseScriptExecution [CP-User] Generate Specs ... FBReactNativeSpec脚本执行失败，使用Windows系统，已执行yarn cache clean --force但无效。

解决方案

1. 修复Expo依赖兼容性

移除package.json中手动指定的resolutions字段，避免依赖版本冲突，让Expo自动管理兼容组件：

// 删除以下内容
"resolutions": {
    "@expo/config-plugins": "~6.0.0",
    "@expo/prebuild-config": "~6.0.0"
}

执行Expo小版本升级，修复已知兼容bug：
```
expo upgrade 48
```

重新安装依赖（Windows环境）：

rd /s /q node_modules
del package-lock.json yarn.lock
yarn install

2. 清理EAS远程构建缓存

本地缓存清理无法解决远程构建环境的缓存问题，执行命令清空iOS构建缓存：

eas build:cache clear --platform ios

3. 排查patch-package补丁影响

项目使用的patch-package可能修改了React Native核心文件，导致Spec生成失败：

临时注释package.json中的postinstall脚本：
```
// "postinstall": "patch-package",
```
重新安装依赖并触发构建，验证是否由补丁导致问题。若构建成功，再逐一排查补丁文件。

4. 指定EAS构建环境配置

在eas.json中为iOS构建profile添加明确的环境配置，确保Node版本和Xcode版本与项目兼容：

{
  "build": {
    "production": {
      "ios": {
        "xcode": "14.2",
        "env": {
          "NODE_VERSION": "18.x"
        }
      }
    },
    "preview": {
      "ios": {
        "xcode": "14.2",
        "env": {
          "NODE_VERSION": "18.x"
        }
      }
    }
  }
}