现有Kotlin Android项目接入Compose启动页报NoSuchMethodError崩溃求解

核心错误原因 #

你遇到的崩溃是Compose编译器版本和Kotlin版本不匹配，导致编译阶段生成的LiveLiterals辅助类缺少预期方法，在Activity类加载阶段触发了类初始化异常，所以崩溃发生在Activity启动之前。

修复步骤 #

• 1. 对齐版本依赖 #

  Compose和Kotlin、AGP（Android Gradle Plugin）的版本必须严格匹配，当前你的配置存在多处版本不兼容问题：

  • 调整Kotlin和Compose版本对应关系：Compose 1.0.2要求Kotlin版本必须为1.5.31，你可以选择升级Kotlin到1.5.31，或者将Compose版本降级到1.0.0-rc02（适配Kotlin 1.5.21）。
  • 替换不稳定AGP版本：你使用的com.android.tools.build:gradle:7.1.0-alpha12是早期测试版本，存在大量已知的Compose编译bug，建议降级到稳定版AGP 7.0.4，完美适配Compose 1.0.x系列。
  • 确保模块build.gradle中已指定Compose编译器版本：

    android {
        composeOptions {
            kotlinCompilerExtensionVersion compose_version
        }
        kotlinOptions {
            jvmTarget = "1.8"
        }
    }
    

• 2. 关闭LiveLiterals编译功能 #

  LiveLiterals是Android Studio提供的Compose预览实时更新功能，版本不兼容时极易生成异常的辅助类，可以通过编译参数关闭该功能避免问题：
  在模块build.gradle的composeOptions中添加配置：

  composeOptions {
      kotlinCompilerExtensionVersion compose_version
      freeCompilerArgs += [
          "-P", "plugin:androidx.compose.compiler.plugins.kotlin:liveLiteralsEnabled=false"
      ]
  }
  

• 3. 修复依赖冲突 #

  你当前项目同时引入了旧Android Support库和AndroidX库，需要开启Jetifier做兼容转换：
  检查gradle.properties文件中是否存在以下配置，缺少则添加：

  android.useAndroidX=true
  android.enableJetifier=true
  

  完成配置后清理所有构建缓存再重新编译：

  # Mac/Linux执行
  ./gradlew clean assembleDebug
  # Windows执行
  gradlew.bat clean assembleDebug
  

  同时建议将所有alpha、beta版本的AndroidX依赖（如activity-ktx:1.4.0-alpha02、navigation-compose:2.4.0-alpha09等）替换为稳定版，避免版本兼容问题。

• 4. 代码验证 #

  完成以上操作后，先创建一个最简测试Activity验证Compose是否可以正常运行，再开发启动页UI：

  class TestActivity : AppCompatActivity() {
      override fun onCreate(savedInstanceState: Bundle?) {
          super.onCreate(savedInstanceState)
          setContent {
              MaterialTheme {
                  Text(text = "测试成功")
              }
          }
      }
  }
  

内容的提问来源于stack exchange，提问作者Ivan Mitsura