Ktor 发布版本
Ktor 遵循语义化版本控制 (Semantic Versioning):
- 主要版本(x.0.0)包含不兼容的 API 变更。
- 次要版本(x.y.0)提供向后兼容的新功能。
- 补丁版本(x.y.z)包含向后兼容的修复。
对于每个主要和次要版本,我们还会发布多个预览(EAP)版本,供您在新功能正式发布前先行试用。欲了解更多详情,请参阅抢先体验计划。
Gradle 插件
Gradle Ktor 插件与框架保持相同的发布周期。 您可以在 Gradle Plugin Portal 上找到所有插件发布版本。
IntelliJ Ultimate 插件
IntelliJ Ktor 插件独立于 Ktor 框架发布, 并与 IntelliJ IDEA Ultimate 采用相同的发布周期。
更新到新版本
IntelliJ Ktor 插件允许您将 Ktor 项目迁移至最新版本。 您可以从迁移项目部分了解更多信息。
版本详情
下表列出了最新 Ktor 版本的详细信息。
| 版本 | 发布日期 | 亮点 |
| 3.6.1 | 2026 年 10 月 30 日 | 补丁版本,修复了连接管理、请求取消、流传输、WebSocket 以及特定平台引擎的各种问题,同时改进了路由、HTTP 规范遵循和资源处理。 |
| 3.6.0 | 2026 年 9 月 17 日 | 次要版本,为 Netty 添加了实验性 HTTP/3 支持,为 Kotlin Multiplatform 提供了默认客户端引擎,增加了 JVM WebRTC 支持,并在客户端和服务端带来了其他功能与改进。 欲了解更多详情,请参阅 Ktor 3.6.0 的最新变化发布日期:2026 年 9 月 17 日。 |
| 3.5.2 | 2026 年 8 月 4 日 | 专注于稳定性和性能的补丁版本,增强了速率限制支持,恢复了文本处理性能,并修复了 I/O 处理、OpenAPI 和配置方面的问题。 |
| 3.5.1 | 2026 年 6 月 26 日 | 补丁版本,包括 OpenAPI 插件改进、扩展的身份验证 KDoc 文档,以及广泛的错误修复,涵盖 Kotlin 2.4 编译器兼容性、HTTP 与缓存行为、身份验证、WebRTC 稳定性以及跨 JVM、Darwin、Android 和 Windows 的特定平台问题。 |
| 3.5.0 | 2026 年 5 月 15 日 | 次要版本,引入了 RFC 7616 Digest 身份验证支持、针对 OkHttp 和 Apache5 的自定义 DNS 解析器配置、请求参数辅助函数,并在配置、会话以及 JavaScript 兼容性方面进行了其他改进。 欲了解更多详情,请参阅 Ktor 3.5.0 的最新变化发布日期:2026 年 5 月 15 日。 |
| 3.4.3 | 2026 年 4 月 22 日 | 专注于稳定性的补丁版本,修复了 OpenAPI 架构推断、客户端引擎生命周期问题,以及若干并发和特定平台错误。 |
| 3.4.2 | 2026 年 3 月 27 日 | 补丁版本,通过内存分配优化和 WebSocket 修复提升了客户端和引擎的性能,并解决了涉及 OpenAPI、日志记录、GraalVM 兼容性、Netty、Darwin、依赖注入、压缩、证书固定(Certificate Pinning)以及 Kotlin/Native 的广泛问题。 |
| 3.4.1 | 2026 年 3 月 4 日 | 补丁版本,包含重要的回归修复,包括解决在 3.4.0 中引入的 Flow 不变性错误并恢复正常的 |
| 3.4.0 | 2026 年 1 月 23 日 | 次要版本,引入了运行时生成的 OpenAPI 规范、Zstd 和 Jackson 3 支持、针对 OkHttp 的全双工流传输,以及数十个增强整个框架可靠性的错误修复。 |
| 3.3.3 | 2025 年 11 月 26 日 | 补丁版本,在 Jetty Client 上添加了明文 HTTP/2(h2c)支持,改进了日志记录和 OpenAPI 生成,并修复了引擎、SSE 处理、重复响应、HTTP/2 标头和客户端缓存中的错误。 |
| 3.3.2 | 2025 年 11 月 5 日 | 补丁版本,为 Darwin 添加了 SOCKS 代理支持,优化了 WebRTC 客户端目标和 Java 代理处理,并修复了 HTTP 重试、OpenAPI、缓存以及 Android 上 Netty 的多个问题。 |
| 3.3.1 | 2025 年 10 月 8 日 | 补丁版本,将 Kotlin 更新至 2.2.20,并修复了多个问题,包括 Content-Length 解析错误、缺少 |
| 3.3.0 | 2025 年 9 月 11 日 | 次要版本,引入了实验性 OpenAPI 生成预览、改进的静态内容处理、面向 Android 和 JS/Wasm 的 WebRTC 客户端等主要功能,并升级至 Jetty、OkHttp 和 Kotlin 2.2。欲了解更多信息,请参阅 Ktor 3.3.0 的最新变化发布日期:2025 年 9 月 11 日。 |
| 3.2.3 | 2025 年 7 月 29 日 | 补丁版本,对 YAML 配置处理、DI 解析以及 Wasm/JS 稳定性进行了改进,同时修复了多部分内容(multipart)解析、CIO |
| 3.2.2 | 2025 年 7 月 14 日 | 补丁版本,改进了 SSE 字段序列化顺序,并解决了多个问题,包括 CORS 预检处理、测试应用程序流传输、配置反序列化错误,以及跨平台缺失标头的问题(包括 3.2.1 中影响 wasmJs 和 Darwin 目标的回归问题)。 |
| 3.2.1 | 2025 年 7 月 4 日 | 补丁版本,包含对时间 API、模板和发布的改进,以及针对插件行为、Netty、OkHttp 和 3.2.0 中引入的启动问题的严重错误修复。 |
| 3.2.0 | 2025 年 6 月 12 日 | 次要版本,引入了类型化配置反序列化、新的依赖注入与 HTMX 模块、Gradle 版本目录支持以及挂起(suspend)模块支持。欲了解更多信息,请参阅 Ktor 3.2.0 的最新变化发布日期:2025 年 6 月 12 日。 |
| 3.1.3 | 2025 年 5 月 5 日 | 补丁版本,包含性能改进(如更快的字节操作和多部分内容处理),以及更安全的令牌刷新处理。该版本还修复了指标中的内存问题,改进了标头行为,解决了 WebSocket、OkHttp、Apache5 和 Netty 方面的错误,并更新了 JTE 以支持 Kotlin 2.1.0。 |
| 3.1.2 | 2025 年 3 月 27 日 | 补丁版本,将 Kotlin 更新至 2.1.20 并修复了各种问题,包括 Base64 解码、认证令牌清除、Android 服务器启动错误、WebSocket 标头格式化以及 SSE 会话取消。 |
| 3.1.1 | 2025 年 2 月 24 日 | 补丁版本,改进了日志记录并修复了 WebSocket 超时处理。修复了多个错误,包括 HTTP 缓存不一致、表单数据复制错误、gzip 处理崩溃,以及导致段池损坏的并发问题。 |
| 3.1.0 | 2025 年 2 月 11 日 | 次要版本,引入了多种 SSE 功能,并扩展了 CIO 引擎和 WebSocket 支持。该版本增强了平台兼容性、日志记录和身份验证,同时修复了与字节通道处理、HTTP 请求失败和并发问题相关的严重错误。 |
| 3.0.3 | 2024 年 12 月 18 日 | 补丁版本,包含多项错误修复,包括修复 |
| 3.0.2 | 2024 年 12 月 4 日 | 补丁版本,解决了与响应损坏、截断主体、连接处理和错误标头相关的多个错误修复,并扩展了二进制编码支持以及针对 Android 的性能增强。 |
| 2.3.13 | 2024 年 11 月 20 日 | 补丁版本,包含错误修复、安全补丁和改进,包括新增对 |
| 3.0.1 | 2024 年 10 月 29 日 | 补丁版本,包含客户端与服务器日志记录的改进,以及多项错误修复。 |
| 3.0.0 | 2024 年 10 月 9 日 | 主要版本,包含多项改进和错误修复,包括新增对 Android Native 目标平台的支持。 有关重大变更的更多信息,请参阅迁移指南本指南提供有关如何将 Ktor 应用程序从 2.2.x 版本迁移到 3.0.x 的说明。。 |
| 3.0.0-rc-2 | 2024 年 10 月 2 日 | 主要版本的候选发布版,包含多项带破坏性变更的改进、错误修复及功能,例如针对 XML 的多平台支持。 |
| 3.0.0-rc-1 | 2024 年 9 月 9 日 | 主要版本的候选发布版,包含显著改进和错误修复。该更新增强了向后兼容性,并提供了扩展的 |
| 3.0.0-beta-2 | 2024 年 7 月 15 日 | 主要版本的预发布版,包含多项改进和错误修复,包括 SSE 支持改进以及适用于 Kotlin/Wasm 的 Ktor 客户端。 |
| 2.3.12 | 2024 年 6 月 20 日 | 补丁版本,包含 Ktor Core 和 Ktor Server 中的错误修复,以及 Netty 和 OpenAPI 的版本更新。 |
| 2.3.11 | 2024 年 5 月 9 日 | 补丁版本,包含为测试客户端引擎应用套接字超时(socket timeout)的错误修复。 |
| 2.3.10 | 2024 年 4 月 8 日 | 补丁版本,包含针对 CallLogging 和 SSE 服务端插件的各种错误修复,改进了 Android 客户端日志记录等。 |
| 2.3.9 | 2024 年 3 月 4 日 | 补丁版本,包含 ContentNegotiation 客户端插件的错误修复,并添加了通过 HTTP 发送安全 Cookie 的支持。 |
| 2.3.8 | 2024 年 1 月 31 日 | 补丁版本,包含 URLBuilder、CORS 和 WebSocket 插件的各种错误修复。 |
| 2.3.7 | 2023 年 12 月 7 日 | 补丁版本,包括 ContentNegotiation、WebSocket 的错误修复,以及 Native Server 中的内存使用优化。 |
| 3.0.0-beta-1 | 2023 年 11 月 23 日 | 主要版本的预发布版,包含多项改进和错误修复,包括客户端和服务端 SSE 支持。 |
| 2.3.6 | 2023 年 11 月 7 日 | 补丁版本,包含对 2.3.5 中破坏性变更的修复以及其他各种错误修复。 |
| 2.3.5 | 2023 年 10 月 5 日 | 补丁版本,包含 Darwin 和 Apache5 引擎配置中的修复。 |
| 2.3.4 | 2023 年 8 月 31 日 | 补丁版本,包含 HTTP Cookie 标头中的错误修复以及 NoTransformationFoundException 错误修复。 |
| 2.3.3 | 2023 年 8 月 1 日 | 补丁版本,包含对 |
| 2.3.2 | 2023 年 6 月 28 日 | 补丁版本,将 Kotlin 版本升级至 |
| 2.3.1 | 2023 年 5 月 31 日 | 补丁版本,包括服务器配置的改进以及各种错误修复。 |
| 2.3.0 | 2023 年 4 月 19 日 | 功能版本,添加了对多配置文件、路由中正则表达式模式等的支持。 |
| 2.2.4 | 2023 年 2 月 28 日 | 补丁版本,包含 HTTP 客户端、路由和 ContentNegotiation 中的各种错误修复。 |
| 2.2.3 | 2023 年 1 月 31 日 | 补丁版本,包括 OAuth2 的多平台功能以及各种错误修复。 |
| 2.2.2 | 2023 年 1 月 3 日 | 补丁版本,包含针对 |
| 2.2.1 | 2022 年 12 月 7 日 | 针对 |
| 2.2.0 | 2022 年 12 月 7 日 | 多项功能发布版本,包括 Swagger UI 托管、新插件 API、会话的多平台支持等。 欲了解更多信息,请参阅从 2.0.x 迁移到 2.2.x本指南介绍了如何将 Ktor 应用程序从 2.0.x 版本迁移到 2.2.x。指南。 |
| 2.1.3 | 2022 年 10 月 26 日 | 包含多项错误修复的补丁版本。 |
| 2.1.2 | 2022 年 9 月 29 日 | 补丁版本,包含路由、测试引擎和 Ktor 客户端中的错误修复。 |
| 2.1.1 | 2022 年 9 月 6 日 | 补丁版本,包含 Ktor 客户端和服务端的各种错误修复。 |
| 2.1.0 | 2022 年 8 月 11 日 | 次要版本,添加了对 YAML 配置的支持以及其他各种改进和错误修复。 |
| 2.0.3 | 2022 年 6 月 28 日 | 补丁版本,包含错误修复并将 |
| 2.0.2 | 2022 年 5 月 27 日 | 补丁版本,包含各种改进、错误修复及依赖项版本升级。 |
| 2.0.1 | 2022 年 4 月 28 日 | 补丁版本,包含各种错误修复,并将 Kotlin 版本更新至 |
| 2.0.0 | 2022 年 4 月 11 日 | 主要版本,更新了 API 文档并包含多项新功能。有关破坏性变更以及如何从 |
| 1.6.8 | 2022 年 3 月 15 日 | 包含依赖项版本升级的补丁版本。 |
