第1章 Ktor初识

课程目录第1章 Ktor初识

一、Ktor 初识：从零开始理解这个轻量级框架

说实话，我第一次接触 Ktor 是在 2018 年。那时候我正为一个 IoT 项目发愁——Spring Boot 太重了，跑在树莓派上简直像穿了件棉袄游泳。后来 JetBrains 推出了 Ktor，我试了试，嗯，真香。

Ktor 是什么？简单说，它是 JetBrains 官方出品的 Kotlin 异步 Web 框架。你可以用它构建服务器、客户端，甚至全栈应用。但它的核心定位很明确：轻量、异步、可组合。

一句话总结：Ktor 就是用 Kotlin 的协程能力，把 HTTP 服务器/客户端做成了乐高积木。你需要什么，就拼什么。

1.1 为什么选择 Ktor？

我见过太多团队在选型时纠结。这里说说我的真实感受。

Kotlin 原生支持：Ktor 从骨子里就是为 Kotlin 设计的。DSL 风格的 API 写起来特别顺，比如路由配置、参数校验，都跟写 Kotlin 扩展函数一样自然。
协程驱动：Ktor 完全基于 Kotlin 协程。这意味着你的代码不会出现回调地狱。我曾经在 Spring WebFlux 里写过一堆 Mono/Flux，说实话，那体验跟 Ktor 的 suspend 函数比起来，差远了。
模块化设计：Ktor 的核心只有几十 KB。你需要 JSON 序列化？加个 ktor-serialization。需要数据库连接？加个 ktor-server-core 配合 Exposed。这种按需加载的方式，让最终打包体积非常小。
多平台支持：同一个 Ktor 客户端代码，可以跑在 JVM、Android、iOS、JS 上。我有个项目就是 Android 端用 Ktor 客户端，后端也用 Ktor 服务器，代码风格完全一致。

我的建议：如果你的团队已经用 Kotlin 写 Android 端，后端选 Ktor 可以大幅降低上下文切换成本。前后端用同一套语言和框架，沟通效率会高很多。

1.2 Ktor 与 Spring Boot 对比

这个问题几乎每次技术分享都会被问到。我直接给结论：没有银弹，看场景。

维度	Ktor	Spring Boot
启动速度	毫秒级（约 200ms）	秒级（约 3-5s）
打包体积	约 5-15 MB（含依赖）	约 30-80 MB（含依赖）
学习曲线	低（熟悉 Kotlin 即可）	中高（注解、IoC、AOP 等概念）
生态成熟度	中等（但核心功能齐全）	极高（几乎什么都有）
异步模型	原生协程	WebFlux（Reactive）或 Servlet
适合场景	微服务、IoT、Android 后端、边缘计算	企业级应用、复杂业务系统

我记得有一次帮朋友重构一个内部工具。原来的 Spring Boot 项目启动要 8 秒，每次改代码重启都让人抓狂。换成 Ktor 后，启动时间降到 300 毫秒，开发效率直接翻倍。但话说回来，如果项目需要对接大量第三方库（比如 Spring Cloud 全家桶），那 Spring Boot 的生态优势确实无可替代。

避坑指南：我曾经在一个项目中强行用 Ktor 替代 Spring Boot，结果发现需要自己实现很多企业级功能（比如分布式事务、统一配置中心）。后来我学乖了：Ktor 适合做「小而美」的服务，Spring Boot 适合做「大而全」的平台。

1.3 Ktor 核心概念

Ktor 的设计哲学很简洁。你不需要理解一堆抽象概念，只需要掌握几个核心组件。

1.3.1 Application

这是 Ktor 的入口。你可以把它理解成整个服务器的「容器」。在 main 函数里，我们通过 embeddedServer 启动它：

fun main() {
    embeddedServer(Netty, port = 8080) {
        // 在这里配置路由、拦截器、插件
    }.start(wait = true)
}

1.3.2 Routing

路由就是 URL 到处理函数的映射。Ktor 用 DSL 风格定义路由，非常直观：

routing {
    get("/hello") {
        call.respondText("Hello, Ktor!")
    }
    post("/user") {
        // 处理 POST 请求
    }
}

你想想看，这种写法是不是比 Spring 的注解更符合 Kotlin 的审美？我个人特别喜欢这种链式调用的感觉。

1.3.3 Plugins

Ktor 的功能扩展全靠插件。比如你想支持 JSON 序列化，就安装 ContentNegotiation 插件：

install(ContentNegotiation) {
    json(Json {
        ignoreUnknownKeys = true
        prettyPrint = true
    })
}

插件机制是 Ktor 的精髓。它不像 Spring 那样通过注解自动装配，而是显式地声明「我需要什么」。这样做的好处是——你永远知道项目里有哪些依赖，不会出现「幽灵配置」。

1.3.4 Pipeline

Pipeline 是 Ktor 处理请求的「流水线」。每个请求都会经过一系列拦截器（interceptors），你可以在这里做日志、鉴权、异常处理等操作。

install(CallLogging) {
    level = Level.INFO
    filter { call -> call.request.path().startsWith("/api") }
}

嗯，这里要注意：Pipeline 的执行顺序很重要。如果你在路由之前安装了鉴权插件，那所有请求都会先过鉴权。这个设计跟 Node.js 的中间件很像，但 Ktor 的类型安全做得更好。

1.3.5 核心架构图

下面这张图展示了 Ktor 处理一个 HTTP 请求的完整流程。从客户端发起到响应返回，每个环节都清晰可见。

1.4 一个完整的入门示例

光说不练假把式。我们写一个最简单的 Ktor 服务器，感受一下它的风格。

import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.routing.*
import io.ktor.server.response.*
import io.ktor.server.application.*

fun main() {
    embeddedServer(Netty, port = 8080) {
        // 安装日志插件
        install(CallLogging)

        // 配置路由
        routing {
            get("/") {
                call.respondText("欢迎来到 Ktor 世界！")
            }
            get("/api/health") {
                call.respond(mapOf("status" to "UP", "version" to "1.0.0"))
            }
        }
    }.start(wait = true)
}

这段代码做了三件事：启动 Netty 服务器、安装日志插件、定义两个路由。没有 XML 配置，没有注解，没有复杂的 IoC 容器。你看到的，就是全部。

小技巧：开发时可以用 embeddedServer 的 module 函数来组织代码。把路由和插件配置抽到单独的文件里，这样 main 函数就只剩一行启动了。

1.5 什么时候该用 Ktor？

我总结了几条经验，供你参考：

Android 后端 API：如果你的 Android 端用 Kotlin，后端用 Ktor 可以共享数据模型和工具类。我有个项目就是这么干的，开发效率至少提升 30%。
微服务/边缘服务：Ktor 启动快、内存占用低，特别适合容器化部署。在 Kubernetes 里，Pod 重启几乎无感。
IoT/嵌入式设备：树莓派、ARM 开发板上跑 Ktor 毫无压力。我曾经在树莓派 Zero 上跑过，内存占用不到 50MB。
学习/原型开发：Ktor 的代码量少，适合快速验证想法。我经常用它写一些内部工具或 Demo。

注意：如果你的项目需要大量第三方集成（比如 Spring Cloud、Netflix OSS、Activiti 工作流），或者团队里 Java 开发者居多，那还是老老实实用 Spring Boot 吧。Ktor 的生态虽然越来越完善，但跟 Spring 比还有差距。

好了，这一章就到这里。Ktor 的核心概念其实不多，但每个都很实用。下一章我们会深入路由和参数处理，到时候我会分享一些我在实际项目中踩过的坑。

公众号:蓝海资料掘金营，微信deep3321

📚 课程目录

一、Ktor 初识：从零开始理解这个轻量级框架

1.1 为什么选择 Ktor？

1.2 Ktor 与 Spring Boot 对比

1.3 Ktor 核心概念

1.3.1 Application

1.3.2 Routing

1.3.3 Plugins

1.3.4 Pipeline

1.3.5 核心架构图

1.4 一个完整的入门示例

1.5 什么时候该用 Ktor？