{"id":741572,"date":"2026-09-20T12:41:12","date_gmt":"2026-09-20T11:41:12","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=ktor&p=741572"},"modified":"2026-09-20T12:41:17","modified_gmt":"2026-09-20T11:41:17","slug":"ktor-3-6-0-is-now-available","status":"publish","type":"ktor","link":"https:\/\/blog.jetbrains.com\/zh-hans\/ktor\/2026\/09\/20\/ktor-3-6-0-is-now-available\/","title":{"rendered":"Ktor 3.6.0 \u6b63\u5f0f\u53d1\u5e03\uff01"},"content":{"rendered":"\n

Ktor 3.6.0 \u6765\u4e86\uff01\u6b64\u7248\u672c\u5305\u542b\u591a\u9879\u5168\u65b0\u5b9e\u9a8c\u6027\u529f\u80fd\uff0c\u5305\u62ec\u7c7b\u578b\u5316\u8eab\u4efd\u9a8c\u8bc1\u80fd\u529b\u3001\u9488\u5bf9 OpenID Connect \u7684\u4e13\u95e8\u652f\u6301\uff0c\u4ee5\u53ca Netty \u5f15\u64ce\u7684 HTTP\/3 \u652f\u6301\u3002\u6b64\u5916\uff0c\u8def\u7531\u4e0e\u8bf7\u6c42\u5904\u7406\u4e5f\u8fce\u6765\u4e86\u4e00\u4e9b\u6613\u7528\u6027\u6539\u8fdb\uff0cKotlin \u591a\u5e73\u53f0\u5ba2\u6237\u7aef\u83b7\u5f97\u4e86\u66f4\u4fbf\u6377\u7684\u9ed8\u8ba4\u914d\u7f6e\uff0c\u53e6\u6709\u66f4\u591a\u66f4\u65b0\u3002\u5b8c\u6574\u53d8\u66f4\u5217\u8868\u8bf7\u53c2\u9605\u6211\u4eec\u7f51\u7ad9\u4e0a\u7684 Ktor 3.6.0 \u65b0\u529f\u80fd<\/a>\uff0c\u6216\u67e5\u770b\u53d1\u5e03\u8bf4\u660e\u3002<\/p>\n\n\n\n

\ud83d\ude80 \u5f00\u59cb\u4f7f\u7528 Ktor 3.6.0<\/h2>\n\n\n\n

\u51c6\u5907\u597d\u63a2\u7d22 Ktor 3.6.0 \u4e86\u5417\uff1f\u4f7f\u7528 start.ktor.io<\/a> \u4ea4\u4e92\u5f0f\u9879\u76ee\u751f\u6210\u5668\uff0c\u5f00\u542f\u4f60\u7684\u4e0b\u4e00\u4e2a\u9879\u76ee\u3002\u6211\u4eec\u59cb\u7ec8\u6b22\u8fce\u4f60\u7684\u53cd\u9988\u548c\u8d21\u732e\uff01<\/p>\n\n\n\n

\n
\n \u5f00\u59cb\u4f7f\u7528 Ktor 3.6.0<\/a>\n <\/div>\n<\/div>\n\n\n\n

\u7c7b\u578b\u5316\u8eab\u4efd\u9a8c\u8bc1<\/h3>\n\n\n\n

\u8fc7\u53bb\uff0cKtor \u7684\u8eab\u4efd\u9a8c\u8bc1\u4f9d\u9760\u9690\u5f0f\u7c7b\u578b\u5c06\u914d\u7f6e\u4e0e\u8def\u7531\u5173\u8054\u8d77\u6765\u3002\u8fd9\u4e2a\u6a21\u5757\u5f15\u5165\u4e86\u65b0\u7c7b\u578b\uff0c\u786e\u4fdd\u5728\u5904\u7406\u590d\u6742\u8eab\u4efd\u9a8c\u8bc1\u65f6\u5177\u5907\u5b8c\u6574\u7684\u7c7b\u578b\u5b89\u5168\uff1b\u540c\u65f6\u652f\u6301\u57fa\u4e8e\u89d2\u8272\u7684\u8bbf\u95ee\u63a7\u5236\u548c\u533f\u540d\u7528\u6237\u3002\u501f\u52a9\u4e0a\u4e0b\u6587\u53c2\u6570\uff0c\u8bed\u6cd5\u4e5f\u66f4\u52a0\u7b80\u6d01\u4f18\u96c5\u3002\u6709\u5173\u8bbe\u7f6e\u3001\u89d2\u8272\u68c0\u67e5\u548c\u5931\u8d25\u5904\u7406\uff0c\u8bf7\u9605\u8bfb\u7c7b\u578b\u5b89\u5168\u8eab\u4efd\u9a8c\u8bc1\u6587\u6863<\/a>\u3002
<\/p>\n\n\n\n

val jwtAuth = jwt<User>(\"my-jwt\") {\n    verifier(jwkProvider, issuer)\n    validate { credential ->\n        val payload = credential.payload\n        User(\n            id = payload.subject,\n            email = payload.getClaim(\"email\").asString()\n        )\n    }\n}\n\nrouting {\n    authenticateWith(jwtAuth) {\n        get(\"\/profile\") {\n            val user = call.principal\n            call.respondText(user)\n        }\n    }\n}<\/pre>\n\n\n\n
OpenID Connect<\/h3>\n\n\n\n
\u5168\u65b0\u7684 OpenID Connect\uff08Oidc<\/code>\uff09\u63d2\u4ef6\u65e8\u5728\u964d\u4f4e\u901a\u8fc7 OpenID Connect \u63d0\u4f9b\u65b9\u4fdd\u62a4\u670d\u52a1\u65f6\u7684\u590d\u6742\u6027\u3002Oidc<\/code> \u63d2\u4ef6\u5141\u8bb8\u4f60\u521b\u5efa\u7c7b\u578b\u5316\u8eab\u4efd\u9a8c\u8bc1\u63d0\u4f9b\u65b9\uff0c\u5e76\u4ee5\u7c7b\u578b\u5b89\u5168\u7684\u65b9\u5f0f\u652f\u6301 OpenID Connect \u7684\u5168\u90e8\u529f\u80fd\u3002\u6b64\u5916\u8fd8\u652f\u6301\u4f1a\u8bdd\u3001\u5177\u5907\u4ee4\u724c\u81ea\u52a8\u5237\u65b0\u529f\u80fd\u7684\u6d4f\u89c8\u5668\u767b\u5f55\u754c\u9762\u7b49\u3002\u5b8c\u6574\u6587\u6863\u8bf7\u67e5\u770b Ktor \u7f51\u7ad9<\/a>\u3002<\/p>\n\n\n\n
suspend fun Application.module() {\n    val oidc = install(Oidc)\n\n    val auth0 = oidc.identityProvider(\"auth0\") {\n        issuer = \"https:\/\/my-tenant.auth0.com\"\n        bearer {\n            audience = setOf(\"https:\/\/api.example.com\")\n        }\n    }\n\n    routing {\n        authenticateWith(auth0.jwtBearer) {\n            get(\"\/orders\") {\n                val subject = call.principal.claims.subject\n                call.respondText(\"Hello $subject\")\n            }\n        }\n    }\n}<\/pre>\n\n\n\n
Netty \u7684\u66f4\u591a\u529f\u80fd <\/h3>\n\n\n\n
Netty \u670d\u52a1\u7aef\u5f15\u64ce\u73b0\u5df2\u901a\u8fc7 QUIC \u63d0\u4f9b\u5b9e\u9a8c\u6027 HTTP\/3 \u652f\u6301\u3002\u82e5\u8981\u542f\u7528\uff0c\u8bf7\u914d\u7f6e SSL \u8fde\u63a5\u5668\uff0c\u7136\u540e\u901a\u8fc7 enableHttp3 { }<\/code> \u9009\u62e9\u542f\u7528\uff1a
<\/p>\n\n\n\n
embeddedServer(Netty, environment, {\n    sslConnector(\n        keyStore = keyStore,\n        keyAlias = \"server\",\n        keyStorePassword = { \"changeit\".toCharArray() },\n        privateKeyPassword = { \"changeit\".toCharArray() }\n    ) { port = 8443 }\n\n    enableHttp3 { quicMaxIdleTimeout = 30.seconds }\n}) { \/* application *\/ }.start(wait = true)\n<\/pre>\n\n\n\n
enableHttp3 {}<\/code> \u4ee3\u7801\u5757\u8fd8\u5141\u8bb8\u4f60\u8c03\u6574 QUIC \u4e13\u7528\u8bbe\u7f6e\uff0c\u4f8b\u5982\u6d41\u91cf\u63a7\u5236\u9650\u5236\u548c UDP \u5957\u63a5\u5b57\u914d\u7f6e\u3002\u6b64\u529f\u80fd\u4ecd\u5904\u4e8e\u5b9e\u9a8c\u9636\u6bb5\uff1b\u5982\u679c\u4f60\u51b3\u5b9a\u8bd5\u7528\uff0c\u6b22\u8fce\u53cd\u9988\u3002<\/p>\n\n\n\n
Netty \u670d\u52a1\u5668\u73b0\u5728\u8fd8\u53ef\u4ee5\u5728\u4e00\u4e2a\u8fde\u63a5\u5668\u4e0a\u63d0\u4f9b h2c\uff0c\u5e76\u5728\u53e6\u4e00\u4e2a\u8fde\u63a5\u5668\u4e0a\u901a\u8fc7 TLS \u63d0\u4f9b HTTP\/2\u3002\u4f7f\u7528 enableH2c = true<\/code> \u548c enableHttp2 = true<\/code> \u53ef\u540c\u65f6\u542f\u7528\u4e8c\u8005\u3002<\/p>\n\n\n\n
embeddedServer(Netty, configure = {\n    connector { port = 8080 }\n    sslConnector(...) { port = 8443 }\n\n    enableHttp2 = true\n    enableH2c = true\n}) { \/* application *\/ }.start(wait = true)<\/pre>\n\n\n\n
\u66f4\u9ad8\u6548\u7684\u8def\u7531\u5904\u7406\u5668<\/h3>\n\n\n\n
\u8bf7\u6c42\u53c2\u6570\u8f6c\u6362\u73b0\u5df2\u652f\u6301 Kotlin \u7684 Uuid<\/code>\u3001Byte<\/code> \u548c\u65e0\u7b26\u53f7\u6570\u503c\u7c7b\u578b\u3002ApplicationCall.receive()<\/code> \u73b0\u5728\u4e5f\u63a5\u53d7\u53ef\u7a7a\u7c7b\u578b\uff0c\u4f7f\u8def\u7531\u5951\u7ea6\u66f4\u52a0\u660e\u786e\uff0c\u540c\u65f6\u5f03\u7528 receiveNullable()<\/code>\u3002<\/p>\n\n\n\n
put(\"\/users\/{id}\") {\n    val id: Uuid by call.parameters\n    val preferences = call.receive<NotificationPreferences?>()\n\n    if (preferences == null) {\n        preferenceService.clear(id)\n    } else {\n        preferenceService.update(id, preferences)\n    }\n    call.respond(HttpStatusCode.NoContent)\n}<\/pre>\n\n\n\n
\u6211\u4eec\u8fd8\u65b0\u589e\u4e86 respondHtmlPartial<\/code>\uff0c\u7528\u4e8e\u53d6\u4ee3\u5df2\u5f03\u7528\u7684 respondHtmlFragment<\/code>\u3002\u65b0\u51fd\u6570\u4f7f\u7528 TagConsumer<Appendable><\/code>\uff0c\u56e0\u6b64\u53ef\u4ee5\u54cd\u5e94\u4e0d\u53d7\u9650\u5236\u7684\u5c40\u90e8 HTML\uff0c\u5e76\u652f\u6301 FlowContent<\/code> \u63d0\u4f9b\u7684\u5168\u90e8\u5143\u7d20\u3002<\/p>\n\n\n\n
get(\"\/status\") {\n    call.respondHtmlPartial(HttpStatusCode.OK) {\n        td { +\"Ready\" }\n    }\n}<\/pre>\n\n\n\n
\u66f4\u7075\u6d3b\u5730\u63a7\u5236 ContentNegotiation<\/code><\/h3>\n\n\n\n
\u5ba2\u6237\u7aef ContentNegotiation<\/code> \u63d2\u4ef6\u8fc7\u53bb\u4f1a\u628a\u5df2\u6ce8\u518c\u7684\u5185\u5bb9\u7c7b\u578b\u5408\u5e76\u5230\u6bcf\u4e2a Accept<\/code> \u8bf7\u6c42\u5934\u4e2d\u3002\u8fd9\u901a\u5e38\u5f88\u6709\u5e2e\u52a9\uff0c\u4f46\u5982\u679c API \u8981\u6c42\u8bf7\u6c42\u4e2d\u663e\u5f0f\u8bbe\u7f6e\u7684\u8bf7\u6c42\u5934\u4fdd\u6301\u539f\u6837\uff0c\u5c31\u5e76\u4e0d\u5408\u9002\u3002<\/p>\n\n\n\n
\u4f7f\u7528 ContentTypeMergeStrategy.SkipIfPresent<\/code> \u65f6\uff0c\u663e\u5f0f Accept<\/code> \u8bf7\u6c42\u5934\u4f18\u5148\u3002\u82e5\u8bf7\u6c42\u6ca1\u6709 Accept<\/code> \u8bf7\u6c42\u5934\uff0c\u63d2\u4ef6\u4ecd\u4f1a\u50cf\u5f80\u5e38\u4e00\u6837\u6dfb\u52a0\u5df2\u6ce8\u518c\u7684\u5185\u5bb9\u7c7b\u578b\uff1a<\/p>\n\n\n\n
install(ContentNegotiation) {\n    register(ContentType.Application.Json, noOpJsonConverter)\n    acceptHeaderMergeStrategy = ContentTypeMergeStrategy.SkipIfPresent\n}<\/pre>\n\n\n\n
\u7b80\u5316 Kotlin \u591a\u5e73\u53f0\u5ba2\u6237\u7aef<\/h3>\n\n\n\n
Ktor 3.6.0 \u5f15\u5165\u4e86 ktor-client-engine-defaults<\/code>\uff1a\u4e00\u7ec4\u4e3a Kotlin \u591a\u5e73\u53f0\u9879\u76ee\u7cbe\u9009\u7684\u5ba2\u6237\u7aef\u5f15\u64ce\u3002\u5c06\u5176\u6dfb\u52a0\u5230 commonMain<\/code> \u540e\uff0c\u5373\u53ef\u5728\u5171\u4eab\u4ee3\u7801\u4e2d\u521b\u5efa HttpClient()<\/code>\uff0c\u65e0\u9700\u9009\u62e9\u5f15\u64ce\u3002Ktor \u4f1a\u4e3a\u6bcf\u4e2a\u76ee\u6807\u5e73\u53f0\u9009\u62e9\u5408\u9002\u7684\u53ef\u7528\u5f15\u64ce\u3002<\/p>\n\n\n\n
HTTP \u7f13\u5b58\u4e5f\u91c7\u7528\u4e86\u540c\u6837\u7684\u601d\u8def\u3002\u57fa\u4e8e\u6587\u4ef6\u7684\u7f13\u5b58\u5b58\u50a8\u73b0\u5728\u4f7f\u7528 kotlinx-io<\/code> \u7684 Path<\/code>\uff0c\u56e0\u6b64\u6301\u4e45\u5316 HttpCache<\/code> \u5b58\u50a8\u4e0d\u518d\u5c40\u9650\u4e8e JVM \u7684 java.io.File<\/code> API\u3002\u7ed3\u5408\u8fd9\u4e9b\u6539\u8fdb\uff0c\u4f7f\u7528\u7b80\u5355\u7f13\u5b58\u914d\u7f6e KMP \u5ba2\u6237\u7aef\u53d8\u5f97\u8f7b\u677e\u8bb8\u591a\uff1a<\/p>\n\n\n\n
\/\/ build.gradle.kts\nkotlin {\n    sourceSets {\n        commonMain {\n            dependencies {\n                api(\"io.ktor:ktor-client-engine-defaults:3.6.0\")\n            }\n        }\n    }\n}\n\n\/\/ Main.kt\nval client = HttpClient() {\n    install(HttpCache) {\n        publicStorage(FileStorage(Path(\"build\/cache\")))\n    }\n}<\/pre>\n\n\n\n
\u8fd9\u8ba9 Ktor \u9879\u76ee\u62e5\u6709\u66f4\u81ea\u7136\u7684\u901a\u7528\u4ee3\u7801\u914d\u7f6e\u65b9\u5f0f\uff0c\u540c\u65f6\u4ecd\u53ef\u5728\u67d0\u4e2a\u5e73\u53f0\u9700\u8981\u65f6\u9009\u62e9\u5e76\u914d\u7f6e\u7279\u5b9a\u5f15\u64ce\u3002<\/p>\n\n\n\n
3.6.0 \u7684\u5b8c\u6574\u53d8\u66f4\u5217\u8868\u8fd8\u5305\u62ec JVM \u7684 WebRTC \u652f\u6301\u3001CIO \u5f02\u6b65 DNS \u89e3\u6790\u3001OpenAPI \u6807\u7b7e\u63cf\u8ff0\u3001\u91cd\u590d Cookie \u89e3\u6790\uff0c\u4ee5\u53ca JavaScript fetch()<\/code> \u8986\u76d6\u7b49\u5185\u5bb9\u3002\u8be6\u60c5\u8bf7\u53c2\u9605 Ktor 3.6.0 \u65b0\u529f\u80fd<\/em><\/a>\u3002<\/p>\n\n\n\n
\ud83d\ude4f \u611f\u8c22\uff01<\/h3>\n\n\n\n
\u611f\u8c22\u793e\u533a\u4e2d\u7684\u6bcf\u4e00\u4f4d\u6210\u5458\u3002\u4f60\u4eec\u7684\u53cd\u9988\u3001\u95ee\u9898\u62a5\u544a\u548c\u8d21\u732e\u8ba9\u6bcf\u4e2a Ktor \u7248\u672c\u90fd\u53d8\u5f97\u66f4\u597d\u3002\u7279\u522b\u611f\u8c22\u5de5\u4f5c\u6210\u679c\u88ab\u7eb3\u5165\u6b64\u7248\u672c\u7684\u5916\u90e8\u8d21\u732e\u8005\uff1akdelay\u3001Rafa Ruiz \u548c solo\u3002<\/p>\n\n\n\n
\u524d\u5f80 start.ktor.io<\/a> \u5f00\u59cb\u6784\u5efa\u4f60\u7684\u4e0b\u4e00\u4e2a\u9879\u76ee\u3002\u6211\u4eec\u59cb\u7ec8\u6b22\u8fce\u4f60\u7684\u5efa\u8bae\u548c\u8d21\u732e\uff01

\ud83d\udc49 \u5f00\u59cb\u4f7f\u7528 Ktor<\/a> | \ud83d\udcac \u5728 Slack<\/a> \u4e0a\u52a0\u5165\u793e\u533a<\/p>\n\n\n\n
\n\n\n\n
\u672c\u535a\u6587\u82f1\u6587\u539f\u4f5c\u8005\uff1aSimon Vergauwen<\/a><\/p>\n\n\n\n
\u672c\u6587\u7531 AI \u8f85\u52a9\u7ffb\u8bd1\uff0c\u5e76\u7ecf\u4eba\u5de5\u5ba1\u6821\u3002\u5982\u53d1\u73b0\u4efb\u4f55\u95ee\u9898\uff0c\u6b22\u8fce\u5728\u8bc4\u8bba\u533a\u7559\u8a00\u6307\u6b63\u3002<\/p>\n\n","protected":false},"author":1297,"featured_media":741573,"comment_status":"closed","ping_status":"closed","template":"","categories":[4897,89,907],"tags":[76,477],"cross-post-tag":[],"class_list":["post-741572","ktor","type-ktor","status-publish","has-post-thumbnail","hentry","category-ktor","category-news","category-releases","tag-news","tag-release"],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ktor\/741572","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ktor"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/types\/ktor"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/users\/1297"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/comments?post=741572"}],"version-history":[{"count":3,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ktor\/741572\/revisions"}],"predecessor-version":[{"id":741597,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ktor\/741572\/revisions\/741597"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media\/741573"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media?parent=741572"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/categories?post=741572"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/tags?post=741572"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/cross-post-tag?post=741572"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}