Expo构建React Native应用遇Gradle版本错误及白屏问题求助

DevOps 小满

2026-8-6

Expo应用Google Play安装白屏+Kotlin Gradle版本不兼容问题解决

问题分析

你遇到的白屏冻结问题根源是Android Gradle插件对Kotlin插件版本有强制要求，当前Expo依赖的org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.10版本不满足要求，导致构建后的安装包运行异常。

解决步骤（无需切换到Bare React Native）

方法1：用Expo官方插件调整Kotlin版本

安装expo-build-properties插件：
```
npx expo install expo-build-properties
```

在app.json或app.config.js中添加版本配置，指定符合Android Gradle插件要求的Kotlin版本（比如AGP 7.4+对应Kotlin 1.8.x）：

{
  "expo": {
    "plugins": [
      [
        "expo-build-properties",
        {
          "android": {
            "kotlinVersion": "1.8.20"
          }
        }
      ]
    ]
  }
}

清理并重新构建项目：

npx expo prebuild --clean
npx expo build:android

方法2：直接修改原生Gradle配置（已prebuild的项目）

如果已经执行过expo prebuild生成原生代码，可以手动调整Kotlin版本：

打开android/build.gradle文件，找到ext.kotlin_version字段，修改为匹配AGP版本的数值（比如AGP 7.0+对应Kotlin 1.6.20+，AGP 7.4+对应1.8.x）：
```
buildscript {
  ext {
    kotlin_version = "1.8.20"
  }
}
```
同步Gradle并重新构建项目。