Kotlin：如何修复错误“Module was compiled with an incompatible version of Kotlin”

遇到过“Module was compiled with an incompatible version of Kotlin”？你不是一个人！

想象一下：你正在用Kotlin编写代码，一切运行正常，但突然——砰！——IDE（或控制台）弹出一条长长的红色消息，上面写着关于“incompatible version of Kotlin”以及1.5.1和1.1.16版本之类的吓人文字。熟悉吗？如果你曾在Android Studio、IntelliJ IDEA中使用过Kotlin，或者只是通过Gradle构建项目，那么这个错误肯定曾让你抓耳挠腮。

好消息是：这个问题解决起来很快，无需大动干戈。坏消息是：如果不搞清楚原因，它会反复出现。今天，我们将彻底剖析这个错误，理解它产生的原因，并永远告别它。开始吧！

这条消息到底是什么意思？

让我们把“计算机语言”翻译成人话。Kotlin，像任何现代语言一样，在不断发展。每个新版本的编译器都会添加功能、修复错误，并……更改内部元数据（描述类和函数的二进制文件）的格式。

当你引入一个第三方库（或项目中的模块）时，编译器会检查：“这个库是用哪个版本的Kotlin编译的？”如果库的元数据版本（例如1.5.1）与你当前编译器期望的版本（例如1.1.16）不匹配，它就会理所当然地报错。这就像试图把旧相机的SD卡插进新笔记本电脑——物理上不兼容。

在我们的例子中，错误信息是：“库（模块）是用元数据版本1.5.1编译的，而我（编译器）期望的是版本1.1.16”。这通常意味着你项目中的Kotlin插件版本已过时，或者反过来，库版本太新。

为什么会发生这种情况？3个主要原因

1. Gradle中版本不一致（最常见）

你是否曾经更新了一个依赖项，却忘记更新Kotlin插件本身？或者反过来——更新了插件，但旧的库还留着？这是拥有大量模块的Android项目的典型情况。

// build.gradle (项目级别)\nplugins {\n    id 'org.jetbrains.kotlin.android' version '1.5.1' apply false // 插件是新的\n}\n\n// build.gradle (模块级别)\ndependencies {\n    implementation 'com.some.library:old-lib:1.0.0' // 而这个库是用Kotlin 1.1.16编译的\n}

编译器看到：插件是1.5.1，库是旧的。于是它大喊：“不兼容！”

2. 多模块项目中的冲突

如果你的项目有多个模块（例如app、core、feature），并且每个模块都有自己的Kotlin版本——那就等着出问题吧。一个模块是用Kotlin 1.5.1编译的，另一个是用1.1.16编译的。当试图将它们连接起来时，就会弹出那个错误。

3. “手动”导入JAR/AAR文件

从网上下载了一个库并放到libs文件夹里？很好，但如果这个库是用与你项目不同的Kotlin版本编译的——你好，错误。

在代码中是什么样子？理解示例

让我们模拟一个场景。你有一个基于Kotlin 1.1.16的项目（是的，很旧，但作为例子没问题）。你引入了一个使用Kotlin 1.5.1最新特性的库。

// 你的代码 (Kotlin 1.1.16)\nfun main() {\n    val result = SomeLibrary().doSomething() // 错误！\n    println(result)\n}

而在库内部（版本1.5.1），使用了例如inline fun interface或sealed interface，这些在旧版本中根本不存在。编译器不明白这是什么，于是报出元数据不兼容的错误。

逐步解决方案：从简单到复杂

步骤1. 检查Kotlin插件版本

打开项目的根build.gradle（或build.gradle.kts）文件。找到包含Kotlin版本的行：

//