使用Ktor Client 1.6.5请求文件时出现NoSuchMethod异常如何解决

问题根因 #

这个异常是典型的JDK跨版本编译兼容性问题：Java 9对java.nio.ByteBuffer的父类java.nio.Buffer下的limit(int)、position(int)等方法做了协变返回类型重载，Java 9及以上版本中ByteBuffer.limit(int)的返回值为ByteBuffer，但Java 8版本中该方法返回值类型为父类Buffer。Ktor 1.6.5的默认CIO引擎是基于高版本JDK编译的，运行在Java 8环境下时就会找不到对应方法签名，抛出该错误。

可行解决方案 #

方案1：升级JDK运行环境 #

直接将运行服务的JDK版本升级到11或更高的LTS版本，即可原生兼容该方法签名，无需修改任何业务代码。

方案2：更换Ktor Client引擎（适配Java 8环境） #

如果必须保留Java 8运行环境，可将默认的CIO引擎替换为兼容性更好的OkHttp引擎：

1. 先在构建脚本中引入OkHttp引擎依赖（以Gradle Kotlin DSL为例）：

implementation("io.ktor:ktor-client-okhttp:1.6.5")

2. 修改客户端初始化代码，指定使用OkHttp引擎，原有请求逻辑无需改动：

val client = HttpClient(OkHttp)
val response = client.get<HttpResponse>("url") {
    headers {
        append(HttpHeaders.Accept, "application/zip")
    }
}

你请求的目标文件体积小于1MB，OkHttp引擎的性能完全可以满足需求，不会有额外性能损耗。

方案3：升级Ktor版本 #

如果可以升级依赖，直接将Ktor Client升级到2.x版本，该版本已经修复了Java 8环境下CIO引擎的兼容性问题，无需更换引擎即可正常运行。

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