Kotlin 1.9.0迁移后出现Hilt Unsupported metadata version错误求助

算力阿峰

2026-6-21

解决Kotlin 1.9.0下Hilt的"Unsupported metadata version"错误

这个错误的核心原因是你使用的Hilt 2.48版本不兼容Kotlin 1.9.0——Kotlin 1.9.0更新了元数据格式，旧版Hilt编译器无法识别，从而抛出该异常。

具体修复步骤：

升级Hilt核心依赖到支持Kotlin 1.9.0的版本（Hilt 2.48.1及以上版本已适配Kotlin 1.9）
统一AndroidX Hilt相关依赖的版本，避免版本不一致导致的兼容问题
确保kotlin-kapt插件版本与你的Kotlin版本（1.9.0）匹配

修改后的配置示例：

插件配置（确保Kotlin版本和插件版本一致）：

plugins {
    id 'com.android.application'
    id 'kotlin-android' version '1.9.0'
    id 'kotlin-kapt' version '1.9.0'
    id 'dagger.hilt.android.plugin' version '2.48.1'
}

kotlinVersion = "1.9.0"

依赖配置：

dependencies {
    ...
    // 升级Hilt核心到兼容Kotlin 1.9的版本
    implementation("com.google.dagger:hilt-android:2.48.1")
    kapt("com.google.dagger:hilt-android-compiler:2.48.1")
    
    // 统一AndroidX Hilt版本，替换旧的alpha版本
    implementation("androidx.hilt:hilt-lifecycle-viewmodel:1.2.0")
    kapt("androidx.hilt:hilt-compiler:1.2.0")
    implementation("androidx.hilt:hilt-navigation-compose:1.2.0")

    implementation 'com.android.support:palette-v7:28.0.0'
}