Skip to content

Ktor 版本

Ktor 遵循 語意化版本

  • 主要版本 (x.0.0) 包含不相容的 API 變更。
  • 次要版本 (x.y.0) 提供回溯相容的新功能。
  • 修正版本 (x.y.z) 包含回溯相容的修正。

對於每個主要和次要版本,我們還會提供多個預覽 (EAP) 版本,供您在正式發佈前嘗試新功能。如需更多詳細資訊,請參閱 早期體驗體計劃

Gradle 外掛程式

Gradle Ktor 外掛程式 與架構處於相同的發佈週期。 您可以在 Gradle 外掛程式入口網站 找到所有外掛程式版本。

IntelliJ Ultimate 外掛程式

IntelliJ Ktor 外掛程式 的發佈獨立於 Ktor 架構, 並使用與 IntelliJ IDEA Ultimate 相同的發佈週期。

更新至新版本

IntelliJ Ktor 外掛程式允許您將 Ktor 專案遷移到最新版本。 您可以從 遷移專案 章節了解更多資訊。

版本詳情

下表列出了最新 Ktor 版本的詳細資訊。

版本發佈日期重點摘要
3.5.02026 年 5 月 15 日

一個次要版本,引入了 RFC 7616 摘要身分驗證支援、適用於 OkHttp 與 Apache5 的自訂 DNS 解析器配置、請求參數輔助函式,以及針對配置、工作階段 (sessions) 與 JavaScript 相容性的其他改進。 如需更多資訊,請參閱

在 GitHub 上查看變更記錄

3.4.32026 年 4 月 22 日

一個專注於穩定性的修正版本,修正了 OpenAPI 架構推斷、用戶端引擎生命週期問題,以及數個並行與平台特定錯誤。

在 GitHub 上查看變更記錄

3.4.22026 年 3 月 27 日

一個修正版本,透過分配優化與 WebSocket 修正改進了用戶端與引擎效能,並解決了涉及 OpenAPI、記錄功能、GraalVM 相容性、Netty、Darwin、相依注入、壓縮、憑證固定以及 Kotlin/Native 的一系列廣泛問題。

在 GitHub 上查看變更記錄

3.4.12026 年 3 月 4 日

一個修正版本,包含重要的迴歸修正,包括解決了 使用引擎分派器 (dispatcher) 執行 HttpStatement 的問題,並恢復了正確的 StreamResetException 傳遞。它還包含效能改進、OpenAPI 增強,以及跨引擎與平台的多項穩定性修正。

在 GitHub 上查看變更記錄

3.4.02026 年 1 月 23 日

一個次要版本,引入了執行階段產生的 OpenAPI 規格、Zstd 和 Jackson 3 支援、OkHttp 的雙工串流,以及數十項增強整個架構可靠性的錯誤修正。

在 GitHub 上查看變更記錄

3.3.32025 年 11 月 26 日

一個修正版本,在 Jetty 用戶端上新增了純文字 HTTP/2 (h2c) 支援,改進了記錄功能與 OpenAPI 產生,並修正了引擎、SSE 處理、重複回應、HTTP/2 標頭和用戶端快取中的錯誤。

在 GitHub 上查看變更記錄

3.3.22025 年 11 月 5 日

一個修正版本,為 Darwin 新增了 SOCKS 代理支援,優化了 WebRTC 用戶端目標和 Java 代理處理,並修正了 HTTP 重試、OpenAPI、快取以及 Android 上的 Netty 等多項問題。

在 GitHub 上查看變更記錄

3.3.12025 年 10 月 8 日

一個修正版本,將 Kotlin 更新至 2.2.20,並修正了多項問題,包括 Content-Length 剖析錯誤、ClientSSESession 遺漏序列化器、Netty 配置與關閉錯誤,並新增了對在 bootJar 內提供靜態資源服務的支援。

在 GitHub 上查看變更記錄

3.3.02025 年 9 月 11 日

一個次要版本,引入了實驗性 OpenAPI 產生預覽、改進的靜態內容處理、適用於 Android 和 JS/Wasm 的 WebRTC 用戶端等主要功能,並升級至 Jetty、OkHttp 和 Kotlin 2.2。如需更多資訊,請參閱

在 GitHub 上查看變更記錄

3.2.32025 年 7 月 29 日

一個修正版本,對 YAML 配置處理、DI 解析以及 Wasm/JS 穩定性進行了改進,同時修正了多部分 (multipart) 剖析、CIO 100 Continue 回應格式化、ByteReadChannel 中的無限讀取迴圈以及伺服器關閉等問題。

在 GitHub 上查看變更記錄

3.2.22025 年 7 月 14 日

一個修正版本,改進了 SSE 欄位序列化順序,並解決了多項問題,包括 CORS 預檢處理、測試應用程式串流、配置反序列化錯誤,以及跨平台遺漏標頭的問題——包括影響 wasmJs 和 Darwin 目載的 3.2.1 迴歸問題。

在 GitHub 上查看變更記錄

3.2.12025 年 7 月 4 日

一個修正版本,包含對時間 API、範本化和發佈的改進,以及針對外掛程式行為、Netty、OkHttp 和 3.2.0 中引入的啟動問題的關鍵錯誤修正。

在 GitHub 上查看變更記錄

3.2.02025 年 6 月 12 日

一個次要版本,引入了型別化配置反序列化、新的相依注入和 HTMX 模組、Gradle 版本型錄支援以及掛起 (suspend) 模組支援。如需更多資訊,請參閱

在 GitHub 上查看變更記錄

3.1.32025 年 5 月 5 日

一個修正版本,包含效能改進(如更快的位元組操作和多部分處理)以及更安全的權杖重新整理處理。它還修正了計量指標中的記憶體問題、改進了標頭行為,並解決了 WebSockets、OkHttp、Apache5 和 Netty 的錯誤,此外還更新了 JTE 以支援 Kotlin 2.1.0。

在 GitHub 上查看變更記錄

3.1.22025 年 3 月 27 日

一個修正版本,將 Kotlin 更新至 2.1.20 並修正了各種問題,包括 Base64 解碼、驗證權杖清除、Android 伺服器啟動錯誤、WebSocket 標頭格式化以及 SSE 工作階段取消。

在 GitHub 上查看變更記錄

3.1.12025 年 2 月 24 日

一個修正版本,改進了記錄功能並修正了 WebSocket 逾時處理。它修正了多個錯誤,包括 HTTP 快取不一致、表單資料複製錯誤、gzip 處理當機以及導致區段池損壞的並行問題。

在 GitHub 上查看變更記錄

3.1.02025 年 2 月 11 日

一個次要版本,引入了多種 SSE 功能,並擴展了 CIO 引擎與 WebSocket 支援。它增強了平台相容性、記錄功能與身分驗證,同時修正了與位元組通道處理、HTTP 請求失敗及並行問題相關的關鍵錯誤。

在 GitHub 上查看變更記錄

3.0.32024 年 12 月 18 日

一個包含各種錯誤修正的修正版本,包括修正 browserProductionWebpack 中的組建錯誤、gzip 內容處理以及 FormFieldLimit 配置覆寫。此版本還包含核心效能改進以及正確的測試應用程式關閉。

在 GitHub 上查看變更記錄

3.0.22024 年 12 月 4 日

一個修正版本,解決了與回應損壞、主體截斷、連線處理以及錯誤標頭相關的多個錯誤,並擴展了二進位編碼支援和 Android 的效能增強。

在 GitHub 上查看變更記錄

2.3.132024 年 11 月 20 日

一個包含錯誤修正、安全性修正與改進的修正版本,包括新增對 watchosDeviceArm64 目標的支援。

在 GitHub 上查看變更記錄

3.0.12024 年 10 月 29 日

一個包含用戶端與伺服器記錄功能改進以及各種錯誤修正的修正版本。

在 GitHub 上查看變更記錄

3.0.02024 年 10 月 9 日

一個包含改進與錯誤修正的主要版本,包括新增對 Android Native 目標的支援。 如需關於破壞性變更的更多資訊,請參閱

遷移指南
undefined

在 GitHub 上查看變更記錄

3.0.0-rc-22024 年 10 月 2 日

一個主要版本候選版,包含各種具有破壞性變更的改進、錯誤修正以及功能,例如對 XML 的多平台支援。

在 GitHub 上查看變更記錄

3.0.0-rc-12024 年 9 月 9 日

一個包含重大改進與錯誤修正的主要版本候選版。此更新增強了回溯相容性,並提供擴展的 staticZip 支援。

在 GitHub 上查看變更記錄

3.0.0-beta-22024 年 7 月 15 日

一個包含各種改進與錯誤修正的主要預覽版本,包括 SSE 支援改進以及適用於 Kotlin/Wasm 的 Ktor 用戶端。

在 GitHub 上查看變更記錄

2.3.122024 年 6 月 20 日

一個修正版本,包含 Ktor Core 和 Ktor Server 的錯誤修正,以及 Netty 和 OpenAPI 的版本更新。

在 GitHub 上查看變更記錄

2.3.112024 年 5 月 9 日

一個修正版本,包含針對測試用戶端引擎套用通訊端逾時的錯誤修正。

在 GitHub 上查看變更記錄

2.3.102024 年 4 月 8 日

一個修正版本,包含 CallLogging 和 SSE 伺服器外掛程式的各種錯誤修正、改進的 Android 用戶端記錄功能等。

在 GitHub 上查看變更記錄

2.3.92024 年 3 月 4 日

一個修正版本,包含 ContentNegotiation 用戶端外掛程式的錯誤修正,以及新增對透過 HTTP 傳送安全 Cookie 的支援。

在 GitHub 上查看變更記錄

2.3.82024 年 1 月 31 日

一個修正版本,包含 URLBuilder、CORS 和 WebSocket 外掛程式的各種錯誤修正。

在 GitHub 上查看變更記錄

2.3.72023 年 12 月 7 日

一個修正版本,包含 ContentNegotiation、WebSockets 中的錯誤修正,以及 Native Server 中的記憶體使用量修正。

在 GitHub 上查看變更記錄

3.0.0-beta-12023 年 11 月 23 日

一個包含各種改進與錯誤修正的主要預覽版本,包括用戶端與伺服器 SSE 支援。

在 GitHub 上查看變更記錄

2.3.62023 年 11 月 7 日

一個修正版本,包含對 2.3.5 中破壞性變更的修正以及各種其他錯誤修正。

在 GitHub 上查看變更記錄

2.3.52023 年 10 月 5 日

一個修正版本,包含 Darwin 與 Apache5 引擎配置中的修正。

在 GitHub 上查看變更記錄

2.3.42023 年 8 月 31 日

一個修正版本,包含 HTTP Cookie 標頭與 NoTransformationFoundException 錯誤的錯誤修正。

在 GitHub 上查看變更記錄

2.3.32023 年 8 月 1 日

一個包含 linuxArm64 用戶端與伺服器支援以及各種錯誤修正的修正版本。

在 GitHub 上查看變更記錄

2.3.22023 年 6 月 28 日

一個將 Kotlin 版本升級至 1.8.22 並包含各種錯誤修正的修正版本。

在 GitHub 上查看變更記錄

2.3.12023 年 5 月 31 日

一個包含伺服器配置改進以及各種錯誤修正的修正版本。

在 GitHub 上查看變更記錄

2.3.02023 年 4 月 19 日

一個功能版本,新增了對多個配置檔案、路由中的正規表示式模式等支援。

在 GitHub 上查看變更記錄

2.2.42023 年 2 月 28 日

一個包含 HTTP 用戶端、路由和 ContentNegotiation 各種錯誤修正的修正版本。

在 GitHub 上查看變更記錄

2.2.32023 年 1 月 31 日

一個修正版本,包含 OAuth2 的多平台功能以及各種錯誤修正。

在 GitHub 上查看變更記錄

2.2.22023 年 1 月 3 日

一個修正版本,包含針對 2.2.1 的錯誤修正、Swagger 外掛程式的改進與修正等。

在 GitHub 上查看變更記錄

2.2.12022 年 12 月 7 日

一個針對 2.2.0java.lang.NoClassDefFoundError: kotlinx/atomicfu/AtomicFU 錯誤的修正版本。

在 GitHub 上查看變更記錄

2.2.02022 年 12 月 7 日

一個包含多項功能的版本,包括 Swagger UI 代管、新的外掛程式 API、工作階段 (Sessions) 的多平台支援等。 如需更多資訊,請參閱

指南。

在 GitHub 上查看變更記錄

2.1.32022 年 10 月 26 日

一個包含各種錯誤修正的修正版本。

在 GitHub 上查看變更記錄

2.1.22022 年 9 月 29 日

一個包含路由、測試引擎與 Ktor 用戶端錯誤修正的修正版本。

在 GitHub 上查看變更記錄

2.1.12022 年 9 月 6 日

一個包含 Ktor 用戶端與伺服器各種錯誤修正的修正版本。

在 GitHub 上查看變更記錄

2.1.02022 年 8 月 11 日

一個次要版本,新增了對 YAML 配置的支援以及各種其他改進與錯誤修正。

在 GitHub 上查看變更記錄

2.0.32022 年 6 月 28 日

一個包含錯誤修正並將 kotlinx.coroutines 版本升級至 1.6.2 的修正版本。

在 GitHub 上查看變更記錄

2.0.22022 年 5 月 27 日

一個包含各種改進、錯誤修正以及相依性版本升級的修正版本。

在 GitHub 上查看變更記錄

2.0.12022 年 4 月 28 日

一個包含各種錯誤修正並將 Kotlin 版本更新至 1.6.21 的修正版本。

在 GitHub 上查看變更記錄

2.0.02022 年 4 月 11 日

一個包含更新的 API 文件與各種新功能的主要版本。如需關於破壞性變更以及如何從 1.x.x 遷移的更多資訊,請參閱

遷移指南
undefined

在 GitHub 上查看變更記錄

1.6.82022 年 3 月 15 日

一個包含相依性版本升級的修正版本。

在 GitHub 上查看變更記錄