Kotlin版本不兼容导致的模块报错

如果在 Kotlin 程序中出现 "模块是用不兼容的 kotlin 版本编译的.其元数据的二进制版本是 1.5.1,预期版本是 1.1.16." 的报错，这说明在编译过程中使用了不兼容的 Kotlin 版本，或者存在不兼容的依赖关系。

原因

这个报错的出现是因为，Kotlin 编译器生成的元数据二进制文件的格式已经更新了，而你的代码或库使用的Kotlin版本不支持这个更新格式，导致出现了版本不兼容的错误。

这个问题在使用 Kotlin 1.2.70 以前的版本开发项目时十分常见，因为在这个版本之后，Kotlin 编译器更新了元数据二进制文件的格式。

解决方案

解决这个问题的方法是让你的代码或库使用一个版本兼容的 Kotlin 编译器版本，可以通过以下几种方式来解决：

1. 升级你的项目到支持最新版 Kotlin 的版本

为了避免出现这个问题，你可以将你的 Kotlin 项目升级到支持最新版本 Kotlin 的版本。这个可以通过使用 Kotlin 官方提供的插件，如下所示：

buildscript {
    ext.kotlin_version = 'x.x.x' // Kotlin 版本
    //...
    dependencies {
        //...
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

apply plugin: 'kotlin-android'
apply plugin: 'kotlin-android-extensions'

2. 升级你的库或依赖文件

如果你使用的是旧版本的 Kotlin 库或依赖文件，那么就需要升级到支持最新版本的 Kotlin。

3. 降低你的项目中使用的 Kotlin 编译器版本

如果你不能升级你的项目或依赖，你还可以降低 Kotlin 编译器版本。你可以在你的项目的 build.gradle 文件中设置支持的Kotlin版本，如下所示：

buildscript {
    ext.kotlin_version = '1.1.60'
    //...
    dependencies {
        //...
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

apply plugin: 'kotlin-android'
apply plugin: 'kotlin-android-extensions'

//...

android {
    ...
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
        kotlinOptions.jvmTarget = "1.8"
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

在这里，你需要将你的项目中支持的 Kotlin 版本设置为 1.1.60。要注意的是，这种解决方案可能会导致你的项目有些功能失效，因为你使用的是一个更旧的 Kotlin 版本。

结论

在 Kotlin 的开发中，升级或降级 Kotlin 版本都是相当常见的操作。当我们出现类似于"模块是用不兼容的 kotlin 版本编译的.其元数据的二进制版本是 1.5.1,预期版本是 1.1.16."的问题时， 只需要升级你的项目到支持最新版 Kotlin 的版本，或者使用一个版本兼容的 Kotlin 编译器版本，就可以很容易地解决这个问题。