导入stack navigator后react-native-screens Kotlin编译报错求助

核心报错特征 #

构建终止提示：

Execution failed for task ':react-native-screens:compileDebugKotlin'.
Compilation error. See log for more details
构建进程抛出JS层调用栈，最终在runOnAllDevices环节触发失败，总构建耗时约13秒。

根因说明 #

这个问题是Stack Navigator接入时的高频问题，核心触发点是Stack Navigator强依赖的react-native-screens库Kotlin编译不通过，常见诱因三类：依赖安装不完整/构建缓存脏污、项目Kotlin版本和react-native-screens要求的版本不匹配、Android端缺少react-native-screens要求的初始化配置。

分步修复方案 #

按顺序操作，每做完一步就尝试重新构建，成功就不用往下走：

• 清理全链路缓存重装依赖
  项目根目录依次执行以下命令：

  # 删除现有依赖目录
  # Windows CMD/PowerShell执行: rd /s /q node_modules
  # Mac/Linux执行: rm -rf node_modules
  
  # 重新安装依赖，npm用户执行npm install，yarn用户执行yarn
  npm install
  
  # 清理Android构建缓存
  cd android
  # Windows执行: gradlew.bat clean
  # Mac/Linux执行: ./gradlew clean
  cd ..
  
  # 重新启动Android构建
  npx react-native run-android
  

• 对齐项目Kotlin版本
  如果清缓存后还是报错，先做版本对齐：
  1. 打开android/build.gradle，找到buildscript.ext配置块，查看当前项目声明的kotlinVersion值
  2. 版本匹配规则：react-native-screens@3.20.x及以上版本要求Kotlin版本≥1.8.0，如果当前项目Kotlin版本低于1.8，直接把kotlinVersion改成1.8.0即可；如果不想升级项目Kotlin版本，就把react-native-screens降到适配低版本Kotlin的3.18.2版本
  3. 改完版本后回到第一步重新清缓存构建
• 补全Android端初始化配置
  打开android/app/src/main/java/[你自己的项目包名]/MainActivity.java，修改onCreate方法为如下写法，注意super.onCreate必须传null：

  @Override
  protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(null);
  }
  

  同时在项目JS入口文件（一般是index.js或者App.js）顶部加一行导入，完成库的初始化：

  import 'react-native-screens';
  

• 精准定位剩余问题
  如果以上操作都没解决，在android目录下执行带完整堆栈的构建命令，查看具体Kotlin编译错误点：

  # Windows执行: gradlew.bat assembleDebug --stacktrace
  # Mac/Linux执行: ./gradlew assembleDebug --stacktrace
  

  常见剩余问题包括：本地Android SDK缺少对应平台版本、其他依赖引入的Kotlin版本冲突，按日志提示的具体错误点对应处理即可。

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