无法将 JVM 1.8 的内联字节码内联到 1.6：深入剖析

引言：当编译器说“不”的时候

您是否曾在控制台中看到过这条令人恐慌的红色错误信息？Cannot inline bytecode built with JVM target 1.8 into bytecode that is being built with JVM target 1.6。如果是这样，您并不孤单。这个错误在 Stack Overflow 上获得了成千上万的浏览量，并成为 Kotlin 开发者的真正绊脚石。但是，如果我告诉您，这条错误信息背后隐藏的不仅仅是一个 bug，而是一整段 Java 虚拟机的进化史呢？

在本文中，我们不仅会展示如何修复这个错误。我们还将深入 Kotlin 编译器的内部，了解什么是 JVM target，内联函数如何工作，以及为什么 1.8 版本的字节码不愿意与 1.6 版本“友好相处”。请系好安全带——这将非常有趣。是的，我们将使用 Kotlin 编写代码，因为这不仅时髦，而且极其方便。

什么是 JVM target，为什么它很重要？

首先，让我们了解一些基本概念。JVM（Java 虚拟机）是执行您的 Kotlin 代码的环境。每个 JVM 版本都能理解特定版本的字节码。例如：

• JVM target 1.6 — 与 Java 6 兼容的字节码。这是一个较旧但稳定的版本。
• JVM target 1.8 — 用于 Java 8 的字节码。增加了对 lambda、Stream API、新注解等特性的支持。

当您在 build.gradle.kts 中编写 kotlin { jvmTarget = "1.8" } 时，您是在告诉编译器：“生成 JVM 1.8 能理解的字节码”。而如果指定 "1.6"，则生成的字节码将与更旧的版本兼容。

当您项目的不同部分（或库）针对不同的 JVM target 进行编译时，问题就出现了。Kotlin 编译器发现不匹配并报错。这尤其影响到内联函数，而内联函数是 Kotlin 中强大的优化工具。

内联函数：它们内部是如何工作的？

在 Kotlin 中，inline 关键字强制编译器将函数代码直接嵌入到调用点。这与普通函数不同，普通函数通过栈进行调用。内联函数可以加速执行（尤其是与 lambda 一起使用时），但会产生一个问题：函数的字节码会被复制到每个调用点。

想象一下，您有一个使用 JVM target 1.8 编译的库。其中包含一个内联函数，该函数使用了 invokedynamic（Java 7/8 中为 lambda 引入的指令）。您将这个库引入到 JVM target 为 1.6 的项目中。编译器尝试将包含 invokedynamic 的字节码内联到不存在该指令的上下文中。于是，它报错了。

// 库中的内联函数示例（使用 target 1.8 编译）inline fun performAction(action: () -> Unit) {    println("之前")    action()    println("之后")}

// 您的代码（使用 target 1.6 编译）fun main() {    performAction { println("你好！") } // 错误：无法内联字节码...}

编译器会报错：“嘿，我无法复制这段字节码，它使用了 JVM 1.8 的特性，而我的 target 是 1.6！”

为什么这在真实项目中会发生？

最常见的原因是 Gradle 依赖项中的版本冲突。例如：

• 您使用了 Kotlin 协程库（该库使用 target 1.8 编译）
• 您的项目配置为 target 1.6（可能是由于过时的模板或兼容性要求）
• 在编译时，Kotlin 尝试内联协程的字节码，但遇到了不兼容问题

另一种情况是 跨模块直接调用内联函数。如果模块 A 使用 target 1.8 编译，而模块 B 使用 target 1.6 编译，并且您在模块 B 中调用了模块 A 的内联函数，则错误是必然的。

实践中是什么样子：示例分析

让我们模拟一个场景。使用 Gradle 创建一个简单的 Kotlin 项目。

// build.gr