EAS Build构建Expo应用时，app.json修改启动屏图片未生效怎么办？

以下是针对该问题的排查和修复步骤：

• 清除本地与EAS构建缓存
  EAS构建默认会复用缓存资源，直接清理后重新构建：

  expo r -c
  eas build --profile development --clear-cache
  

  也可以完全禁用缓存强制重新构建：

  eas build --profile development --no-cache
  

• 验证图片资源配置
  确认splash1.png存放在项目根目录的assets文件夹下，注意文件名大小写（macOS/Linux系统区分大小写）。运行expo assets:list命令，检查该图片是否被Expo正确识别。

• 检查app.json配置是否被覆盖
  确保app.json中基础的splash配置没有被环境特定配置（如config.development）覆盖，示例正确配置如下：

  {
    "expo": {
      "splash": {
        "image": "./assets/splash1.png",
        "resizeMode": "cover",
        "backgroundColor": "#ffffff"
      },
      "config": {
        "development": {
          // 此处不要添加覆盖splash的配置
        }
      }
    }
  }
  

• 清理原生项目构建缓存

  • iOS：打开Xcode，点击菜单栏Product → Clean Build Folder，再重新执行EAS构建。
  • Android：在项目根目录执行./gradlew clean（Windows系统用gradlew clean），之后重新构建。

• 检查expo-splash-screen代码逻辑
  如果项目使用expo-splash-screen库，确保启动逻辑中没有硬编码旧启动屏路径或强制加载缓存资源，避免错误的缓存逻辑影响启动屏更新。

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