Ktor Server支持的JVM目标版本及Heroku部署POST请求报错咨询

错误现象 #

过去几个月本地运行Ktor服务端应用并部署到Heroku一直正常，部署最新版本后，Heroku上所有处理请求体的POST请求都抛出如下错误：

java.lang.NoSuchMethodError: java.nio.ByteBuffer.limit(I)Ljava/nio/ByteBuffer;
    at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
    at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62)
    at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
    at java.lang.reflect.Constructor.newInstance(Constructor.java:423)
    at io.ktor.utils.io.ExceptionUtilsJvmKt$createConstructor$$inlined$safeCtor$3.invoke(ExceptionUtilsJvm.kt:103)
    at io.ktor.utils.io.ExceptionUtilsJvmKt$createConstructor$$inlined$safeCtor$3.invoke(ExceptionUtilsJvm.kt:90)
    at io.ktor.utils.io.ExceptionUtilsJvmKt.tryCopyException(ExceptionUtilsJvm.kt:66)
    at io.ktor.utils.io.ByteBufferChannelKt.rethrowClosed(ByteBufferChannel.kt:2456)
    at io.ktor.utils.io.ByteBufferChannelKt.access$rethrowClosed(ByteBufferChannel.kt:1)
    at io.ktor.utils.io.ByteBufferChannel.readRemaining$suspendImpl(ByteBufferChannel.kt:2126)
    at io.ktor.utils.io.ByteBufferChannel.readRemaining(ByteBufferChannel.kt)
    at io.ktor.utils.io.ByteReadChannelKt.readRemaining(ByteReadChannel.kt:217)
    at io.ktor.serialization.SerializationConverter.convertForReceive(SerializationConverter.kt:158)
    at io.ktor.features.ContentNegotiation$Feature$install$3.invokeSuspend(ContentNegotiation.kt:224)
    at io.ktor.features.ContentNegotiation$Feature$install$3.invoke(ContentNegotiation.kt)
    at io.ktor.features.ContentNegotiation$Feature$install$3.invoke(ContentNegotiation.kt)
    at io.ktor.util.pipeline.SuspendFunctionGun.loop(SuspendFunctionGun.kt:248)
    at io.ktor.util.pipeline.SuspendFunctionGun.proceed(SuspendFunctionGun.kt:116)
    at io.ktor.util.pipeline.SuspendFunctionGun.execute(SuspendFunctionGun.kt:136)
    at io.ktor.util.pipeline.Pipeline.execute(Pipeline.kt:78)
    at io.ktor.request.ApplicationReceiveFunctionsKt.receive(ApplicationReceiveFunctions.kt:116)
    at io.ktor.request.ApplicationReceiveFunctionsKt.receiveOrNull(ApplicationReceiveFunctions.kt:135)

排查过程 #

• 最初怀疑是请求体格式异常，将call.receive<MyObject>()修改为call.receiveOrNull<MyObject>()，问题未得到解决。
• 后续定位到是JVM版本不匹配问题：Heroku默认JVM版本为1.8，本地切换到Java 1.8运行应用后成功复现该问题。
• 将Heroku应用的目标JVM版本修改为11后，问题彻底解决。

根因分析 #

该错误是典型的JDK跨版本编译兼容性问题：Java 9对java.nio.ByteBuffer的部分方法签名做了改动，JDK 8中limit(int)方法返回值为Buffer类型，JDK 9及更高版本中该方法返回值改为ByteBuffer类型。如果Ktor及其依赖组件是用JDK 9+编译的，运行在JDK 8环境下就会找不到对应方法签名，抛出NoSuchMethodError。

本次问题触发原因是新增Ktor的Authentication特性时，对应的Ktor版本或其依赖组件已经将最低编译目标JDK版本提升到9以上，不再兼容Java 8运行环境。

Ktor JVM版本支持说明 #

• Ktor 2.x及更高版本最低要求JVM目标版本为11，不再支持Java 8运行环境。
• 如果必须使用Java 8运行，需要将Ktor版本降级到1.6.x及更早的兼容版本。

后续避坑建议 #

• 开发、测试、生产环境保持JVM版本完全一致，避免出现跨版本兼容性问题。
• 升级Ktor版本前，先核对对应版本的JVM依赖要求，确认和当前运行环境匹配。
• 若受环境限制只能使用Java 8，需锁定Ktor版本到1.6.x及更低兼容版本，不要升级到2.x系列。

内容的提问来源于stack exchange，提问作者Derek Lee