Kotlin Ktor Client如何直接添加Cookie对象到请求？

在使用Ktor发送HTTP请求时，官方提供的HttpMessageBuilder.cookie(...)函数仅支持传入单个Cookie属性参数，无法直接接收Cookie对象作为参数。

我曾尝试通过复制Cookie对象的属性来调用该函数，但因为cookie(...)函数没有encoding参数，导致这个实现无法生效：

fun HttpRequestBuilder.applyCookie(cookie: Cookie) = cookie.run {
    cookie(
        name = name,
        value = value,
        maxAge = maxAge,
        expires = expires,
        domain = domain,
        path = path,
        secure = secure,
        httpOnly = httpOnly,
        extensions = extensions
    )
}

之后我参考Ktor内部的实现逻辑，自己写了一个可行的applyCookie扩展函数，通过渲染Cookie头并直接操作请求头来实现添加Cookie的功能：

fun HttpRequestBuilder.applyCookie(cookie: Cookie) = cookie.run {
    val renderedCookie = cookie.let(::renderCookieHeader)
    if (HttpHeaders.Cookie !in headers) {
        headers.append(HttpHeaders.Cookie, renderedCookie)
        return
    }
    // Client cookies are stored in a single header "Cookie" and multiple values are separated with ";"
    headers[HttpHeaders.Cookie] = headers[HttpHeaders.Cookie] + "; " + renderedCookie
}

结论 #

目前Ktor的官方API中确实没有提供直接接收Cookie对象的原生扩展方法，需要通过自定义扩展函数的方式来实现这个需求。上述的自定义实现已经能够正确处理Cookie的添加逻辑，包括多个Cookie的拼接格式。

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