罗罗编程学习记录
本页内容 展开查看

06.8.1.3 客户端、WebSocket、测试与部署

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.8 Kotlin 后端 / 06.8.1 Ktor 框架

本节要解决的问题

  • Ktor Client 的引擎选择、实例复用、请求构造、超时、重试、序列化与日志插件如何落地。
  • WebSocket 服务端与客户端的会话生命周期、帧类型、心跳、重连与状态管理;SSE 的适用边界。
  • testApplication/MockEngine 测试方式,以及引擎选型、Docker、优雅停机、探针与多实例部署;版本基线 Ktor 3.x、Kotlin 2.x,不确定 API 标「待确认」。

06.8.1.3-001 Ktor Client 的整体定位与组成是什么?

一句话结论

Ktor Client 是协程导向的 HTTP 客户端,由引擎、配置、插件与请求/响应模型组成;与服务端同构的插件机制装配序列化、认证、日志、超时等能力,面向异步调用场景。

概念解释

客户端职责是构造请求、执行网络调用、解析响应。引擎决定连接实现与线程模型;插件提供横切能力;请求 DSL 描述方法、URL、头与 body。客户端实例可复用,内部维护连接池。

原理流程

  1. 构造 HttpClient 并选定引擎工厂。
  2. 安装客户端插件(序列化、日志、认证等)。
  3. 通过请求 DSL 发起调用。
  4. 响应经插件链解析为类型化结果。

代码或图示

val client = HttpClient(CIO) {
    install(ContentNegotiation) { /* ... */ }
}

常见误区

  • 把客户端当一次性工具每次新建:连接池无法复用。
  • 忽略关闭实例:连接与线程资源泄漏。

追问

  • 客户端与服务端插件 API 完全一致吗?答:机制同构,具体插件集合与配置项有差异,以客户端文档为准。
  • 待确认:Ktor 3 客户端引擎清单,以官方文档核对。

06.8.1.3-002 客户端引擎有哪些,如何选型?

一句话结论

客户端引擎包括 CIO、Apache、Java 等实现(具体可用清单以版本为准);选型看异步模型、依赖体积、TLS 能力与既有运行时;协程原生场景优先协程导向引擎,阻塞兼容需求选对应实现。

概念解释

引擎决定 HTTP 客户端底层实现:连接管理、线程模型、异步回调方式。业务代码通过统一 HttpClient 接口与引擎解耦,可按测试与生产替换。引擎差异在超时、连接池与代理支持上体现。

原理流程

  1. 列出可用引擎与依赖约束。
  2. 评估异步模型与项目运行时。
  3. 验证 TLS、代理、连接池能力。
  4. 压测对比吞吐与延迟后选定。

代码或图示

HttpClient(CIO) { /* 协程导向 */ }
HttpClient(Apache) { /* 阻塞兼容实现,能力以引擎为准 */ }

常见误区

  • 不核对引擎能力:某些高级配置只在特定引擎生效。
  • 引擎切换后不回归:连接与超时行为可能变化。

追问

  • 待确认:Ktor 3 客户端各引擎维护状态与推荐场景,以官方文档核对。
  • 测试中能换引擎吗?答:可以,测试可用 MockEngine 或轻量引擎。

06.8.1.3-003 HttpClient 的构造与配置入口是什么?

一句话结论

HttpClient(引擎工厂) { 配置闭包 } 构造实例:闭包内配置引擎参数、安装插件、设置默认请求头与超时;配置在构造期确定,实例共享同一套默认策略。

概念解释

配置闭包覆盖引擎连接参数、插件安装、默认请求与响应处理。实例构造一次后复用;每次请求可局部覆盖默认头与参数。配置项按引擎与插件分别组织。

原理流程

  1. 传入引擎工厂。
  2. 闭包配置引擎与默认策略。
  3. 安装插件并配置。
  4. 实例就绪后发起请求。

代码或图示

val client = HttpClient(CIO) {
    engine { /* 连接参数,按引擎 API */ }
    install(Logging) { /* ... */ }
    defaultRequest { header("X-Client", "ktor") }
}

常见误区

  • 每次请求 new HttpClient:连接池与线程重建成本高。
  • 在请求内改全局默认配置:影响其他调用方。

追问

  • 待确认:defaultRequest 与引擎配置 API 名称,以客户端文档核对。
  • 不同下游能否用不同实例?答:可以,按下游隔离连接池与策略。

06.8.1.3-004 客户端实例应该复用还是每次新建?

一句话结论

长生命周期服务内应复用客户端实例:内部连接池、线程与插件状态可复用;按下游或策略分组实例,不要每个请求新建;实例在应用停机时统一关闭。

概念解释

新建实例会重复建立连接池与线程资源,高并发下造成连接与线程耗尽。复用实例需线程安全,客户端设计为可并发共享。不同超时、认证或连接池要求的下游可拆成独立实例。

原理流程

  1. 应用装配期构造客户端实例。
  2. 业务协程并发共享实例发请求。
  3. 连接复用由内部池管理。
  4. 停机事件中关闭实例释放资源。

代码或图示

// 装配期构造,注入到服务层
val apiClient = HttpClient(CIO) { /* ... */ }

常见误区

  • 请求内 HttpClient(CIO).use { }:每次重建池连接。
  • 复用实例却在内部存可变请求状态:并发污染。

追问

  • 实例关闭后还能发请求吗?答:不能,已关闭实例调用失败,需重新构造。
  • 多下游共享一个实例的风险?答:连接池与超时互相影响,关键下游建议隔离。

06.8.1.3-005 请求构造:方法、URL、头与参数如何写?

一句话结论

请求 DSL 指定 HTTP 方法、URL、请求头、查询参数与 body;URL 拼接走 DSL 参数能力,避免手拼编码;公共头在客户端默认请求配置,单次请求可覆盖。

概念解释

请求构造分方法、地址、元数据与载荷。查询参数由 DSL 编码,路径段按参数拼接;头区分默认公共头与单次请求头。body 在需要时设置并指定内容类型。

原理流程

  1. 选择方法动词(get/post/put 等)。
  2. 构造 URL 与查询参数。
  3. 补充请求头与 body。
  4. 发送并接收响应。

代码或图示

client.get("/users") {
    header("X-Trace-Id", traceId)
    parameter("page", 1)
}

常见误区

  • 手写拼接 URL 含中文/空格:编码错误导致 400。
  • 单次请求覆盖默认头却未恢复:影响同实例其他请求。

追问

  • 待确认:请求 DSL 参数方法名(parameter/url)在 Ktor 3 中的形式,以文档核对。
  • 路径变量怎么填?答:在 URL 模板中替换段值,注意编码。

06.8.1.3-006 响应读取:状态、头与 body 如何解析?

一句话结论

响应对象暴露状态码、响应头与 body;body 可按类型反序列化(对象)或取字符串/字节;先判状态码再解析 body,错误响应体按错误结构读取;未消费 body 可能影响连接复用。

概念解释

响应处理顺序:状态判定 -> 头读取 -> body 解析。成功与错误 body 结构可能不同,需要分别反序列化。响应体必须被消费或正确释放,否则连接无法归还池。

原理流程

  1. 发起请求得到 HttpResponse。
  2. 判定状态码分支。
  3. 按类型反序列化 body 或读字节/文本。
  4. 消费完成连接归还池。

代码或图示

val response = client.get<UserDto>("/users/1")
// 或先取响应再判状态
val res = client.get("/users/1")
if (res.status == HttpStatusCode.OK) { /* ... */ }

常见误区

  • 不判状态直接反序列化:错误 body 解析失败掩盖真实错误。
  • body 未读取就复用连接:连接泄漏风险。

追问

  • 待确认:body 读取 API(receive/body)与可空行为,以客户端文档核对。
  • 响应头多值怎么取?答:按多值读取 API 获取列表。

06.8.1.3-007 客户端如何发送 JSON 对象?

一句话结论

安装客户端 ContentNegotiation 插件配置序列化器,post/put 时传入对象,插件按 Content-Type 序列化并设置头;发送 DTO 与接收类型共用同一序列化配置以保证兼容。

概念解释

对象发送经过序列化插件:对象 -> JSON 字节 -> 请求体。序列化配置(未知键、命名策略、日期格式)与服务端对齐。错误场景可手动发送字符串或字节。

原理流程

  1. 客户端安装序列化插件并配置 Json。
  2. 请求 body 传入 DTO 对象。
  3. 插件序列化为字节并设 Content-Type。
  4. 响应反序列化走同一配置。

代码或图示

install(ContentNegotiation) {
    json(Json { ignoreUnknownKeys = true })
}
client.post("/users") {
    contentType(ContentType.Application.Json)
    setBody(UserDto(name = "Ann"))
}

常见误区

  • 只配置接收方向:发送对象无法序列化。
  • 客户端与服务端序列化配置不一致:字段解析偏差。

追问

  • 待确认:客户端 json 转换器依赖坐标,以官方文档核对。
  • 发送表单用哪个插件/方式?答:见表单上传题目。

06.8.1.3-008 表单与 multipart 上传怎么做?

一句话结论

application/x-www-form-urlencoded 用表单参数提交;文件上传用 multipart 部件构建,字段与文件部件分别添加;大文件流式提供,避免全量入内存;完成后释放部件资源。

概念解释

表单编码适合简单键值对;multipart 混合字段与文件二进制。客户端构造 multipart 数据集,按部件提供文件名、类型与流。上传大小与超时按文件规模调整。

原理流程

  1. 判定表单类型。
  2. 键值表单直接填参数。
  3. multipart 添加字段部件与文件部件。
  4. 发送并消费响应。

代码或图示

client.post("/upload") {
    boundary = "----boundary"
    setBody(MultiPartFormDataContent(formData {
        append("description", "avatar")
        append("file", bytes, Headers.build { /* 文件名/类型 */ })
    }))
}

常见误区

  • 文件字节全量加载进内存:大文件 OOM。
  • 部件文件名/类型缺失:服务端解析异常。

追问

  • 待确认:Ktor 3 multipart 构造 API 名称与部件释放方式,以文档核对。
  • 上传进度怎么获取?答:引擎/库支持时取进度回调,能力以实现为准。

06.8.1.3-009 请求超时如何配置?

一句话结论

客户端可配置连接超时、请求超时(等待响应)与套接字读/写超时;超时按下游 SLA 分级,避免无限等待;超时异常映射为失败重试或降级,不同超时类型不要混为一谈。

概念解释

连接超时控制建立连接等待;请求超时控制整体响应等待;读写超时控制单次 IO 等待。下游慢调用必须设限,否则占用协程与连接。超时值按接口重要性与下游能力设定。

原理流程

  1. 在客户端或单次请求配置超时项。
  2. 连接/等待/读写分别计时。
  3. 超时抛对应异常。
  4. 上层决定重试或降级。

代码或图示

install(HttpTimeout) {
    requestTimeoutMillis = 2_000
    connectTimeoutMillis = 1_000
    socketTimeoutMillis = 2_000
}

常见误区

  • 只设整体超时不控连接:连接建立阶段卡住。
  • 超时无限放大:下游长尾拖垮自身线程与连接池。

追问

  • 待确认:HttpTimeout 插件配置项名称与默认值,以官方文档核对。
  • 重试与超时如何配合?答:有限重试 + 退避,总时长仍受上游超时约束。

06.8.1.3-010 连接池与 Keep-Alive 参数如何理解?

一句话结论

客户端内部维护连接复用池,Keep-Alive 决定连接存活复用;池大小、空闲连接存活与等待队列按下游并发量配置;池满时新建连接或排队,参数依引擎实现。

概念解释

连接复用减少握手开销;池参数影响并发与资源占用。不同引擎的池实现与可配置项不同,不要假设参数同名。连接泄漏(响应未消费)会导致池内连接不可复用。

原理流程

  1. 配置引擎连接池大小与存活时间。
  2. 请求优先取空闲连接。
  3. 池满按引擎策略新建或排队。
  4. 响应消费后连接归还池。

代码或图示

连接池:空闲复用 / 上限 / 空闲存活 / 等待策略(按引擎配置)

常见误区

  • 池上限设过大:下游连接数被打满。
  • 不消费响应体:连接无法归还,池逐渐耗尽。

追问

  • 待确认:各客户端引擎连接池配置入口,以引擎文档核对。
  • 连接复用失效看什么?答:连接关闭头、代理断开与响应未消费日志。

06.8.1.3-011 客户端插件体系与服务端一致吗?

一句话结论

机制同构:都是 install 装配、管道拦截、配置闭包;插件集合不同——客户端有超时、重试、Cookie、代理等方向插件,服务端有认证、路由、内容协商等方向插件;同名插件行为按客户端语义适配。

概念解释

理解服务端插件模型可迁移到客户端:安装期配置、请求/响应阶段拦截、属性传递。客户端插件作用于出站请求与入站响应,不涉及路由匹配。跨端共享的是序列化配置思路,不是插件实例。

原理流程

  1. 客户端构造时 install 插件。
  2. 插件注册请求/响应阶段拦截。
  3. 请求出站前与响应入站后触发插件逻辑。
  4. 插件共享客户端级配置与状态。

代码或图示

HttpClient(CIO) {
    install(HttpTimeout) { /* 出站超时 */ }
    install(Logging) { /* 请求/响应日志 */ }
}

常见误区

  • 把服务端认证插件直接搬到客户端:职责方向不同。
  • 客户端插件里保存请求级可变状态:并发调用污染。

追问

  • 待确认:Ktor 3 客户端插件清单,以官方客户端文档核对。
  • 插件顺序影响什么?答:请求修改与日志记录的包裹层次,同服务端管道逻辑。

06.8.1.3-012 Logging 插件如何记录请求与响应?

一句话结论

Logging 插件在请求/响应阶段记录方法、URL、头与 body;配置日志级别与 body 打印开关;生产环境脱敏敏感头与令牌,避免完整 body 写入日志;日志层级按环境区分。

概念解释

插件可记录请求行、头、报文体与响应状态。body 记录受大小与级别限制;敏感凭据、Cookie、令牌必须脱敏。生产默认降低 body 日志级别,排查问题时临时开启。

原理流程

  1. 安装 Logging 插件并配置级别。
  2. 请求出站前记录方法/URL/头。
  3. 响应入站后记录状态与(可选)body。
  4. 敏感字段在日志层脱敏。

代码或图示

install(Logging) {
    level = LogLevel.INFO
    // 敏感头在日志输出前过滤,按插件能力配置
}

常见误区

  • 生产打印 Authorization 与完整 body:敏感信息入日志。
  • 日志 body 不限制大小:大响应撑爆日志存储。

追问

  • 待确认:Logging 插件级别枚举与脱敏配置方式,以官方文档核对。
  • 日志走哪个日志门面?答:按项目日志接入,插件输出可桥接到应用日志。

06.8.1.3-013 客户端 ContentNegotiation 如何接入?

一句话结论

与服务端同构:安装客户端序列化插件,配置 Json/Jackson 转换器;请求对象自动序列化,响应按类型反序列化;配置与下游服务对齐,未知键策略按兼容需要设定。

概念解释

客户端协商插件负责出站 body 编码与入站 body 解码。转换器按媒体类型匹配;默认 Accept 头由插件协商决定。与服务端共用 DTO 与序列化配置可减少往返偏差。

原理流程

  1. 安装客户端 ContentNegotiation。
  2. 配置序列化器与 Json 策略。
  3. 请求 setBody 对象时编码。
  4. 响应按接收类型解码。

代码或图示

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

常见误区

  • 客户端忽略未知键策略与服务端不一致:新版本字段解析异常。
  • 响应期望类型与实际媒体类型不符:解码失败。

追问

  • 待确认:客户端 Jackson 转换器接入方式,以文档核对。
  • 非 JSON 响应怎么读?答:直接取字符串/字节,不走对象转换器。

06.8.1.3-014 客户端 Auth 插件如何携带凭据?

一句话结论

认证插件或默认请求头为出站请求附加凭据:Bearer 令牌、Basic 用户名密码或自定义签名头;凭据从安全配置获取,不写进代码;不同下游按实例隔离凭据。

概念解释

客户端凭据携带是出站横切:插件在请求出站前附加认证头。Basic 编码、Bearer 格式化由插件/DSL 完成。令牌刷新后更新实例配置,注意不要在日志中输出凭据。

原理流程

  1. 装配期获取凭据来源。
  2. 认证插件/默认请求附加凭据头。
  3. 出站请求携带凭据。
  4. 凭据轮换时更新配置或实例。

代码或图示

defaultRequest {
    header(HttpHeaders.Authorization, "Bearer $token")
}

常见误区

  • 凭据硬编码在源码或配置仓库:泄露风险。
  • 多下游共用实例携带同一凭据:越权调用。

追问

  • 待确认:Ktor 客户端是否提供认证插件及 provider 配置,以官方文档核对。
  • 令牌过期在客户端怎么处理?答:刷新后更新请求头,配合 401 刷新流程。

一句话结论

Cookie 插件维护出站 Cookie 与入站 Cookie 存储;可配置 Cookie 存储策略(内存/自定义);跨域调用注意 Domain、Path 与安全属性;不要在手动头里重复处理插件管理的 Cookie。

概念解释

插件按响应 Set-Cookie 更新存储,后续请求按规则回带。Cookie 存储生命周期与客户端实例一致;敏感 Cookie 随实例关闭清理。手动管理与插件存储混用会导致重复或冲突。

原理流程

  1. 安装 Cookies 插件并配置存储。
  2. 响应 Set-Cookie 写入存储。
  3. 出站请求按 Domain/Path 匹配回带。
  4. 实例关闭清理存储。

代码或图示

install(Cookies) {
    // 存储配置按插件 API
}

常见误区

  • 插件与手动 Cookie 头同时设置:Cookie 重复或冲突。
  • 跨域 Domain 配置过宽:不必要回带 Cookie。

追问

  • 待确认:Ktor 3 Cookies 插件存储接口与配置,以官方文档核对。
  • 分布式调用需要保持会话吗?答:无状态 API 优先令牌,Cookie 会话按浏览器场景使用。

06.8.1.3-016 客户端 Compression 插件如何工作?

一句话结论

客户端在请求 Accept-Encoding 声明可解压编码,对压缩响应自动解压;是否启用压缩按下游与报文权衡;解压在客户端完成,业务读到原始 body。

概念解释

压缩协商是双向的:客户端声明支持编码,服务端选择编码压缩,客户端解压还原。插件处理 Content-Encoding 解码,业务不感知编码格式。文本报文压缩收益明显,二进制通常不压。

原理流程

  1. 安装 Compression 插件。
  2. 出站请求带 Accept-Encoding。
  3. 响应带 Content-Encoding 时插件解压。
  4. 业务读取原始 body。

代码或图示

install(Compression) { /* 支持编码按插件配置 */ }

常见误区

  • 以为发送给下游的 body 被压缩:压缩主要针对响应方向,按插件能力确认。
  • 不解压直接解析压缩字节:解码失败。

追问

  • 待确认:客户端 Compression 支持的编码与配置项,以文档核对。
  • 大响应解压占内存吗?答:占用解压缓冲,流式响应需关注内存。

06.8.1.3-017 重试插件如何配置?

一句话结论

重试插件按条件(异常、可重试状态码)在有限次数内退避重试;只对幂等或安全可重试的调用重试,非幂等写操作谨慎;退避用指数间隔加抖动,总时长受超时约束。

概念解释

重试用于应对瞬时网络抖动与短暂 5xx。重试条件区分连接失败、读超时与 4xx 客户端错误;4xx 一般不重试。重试放大下游压力,必须限次并配合熔断。插件配置最大次数、延迟条件与可重试判定。

原理流程

  1. 配置最大重试次数与退避规则。
  2. 调用失败判定是否可重试。
  3. 退避后重试,次数递增。
  4. 超过次数抛出最后一次异常。

代码或图示

install(Retry) {
    maxRetries = 2
    // 退避与可重试条件按插件 API 配置
}

常见误区

  • 对 POST 非幂等请求盲目重试:重复下单/扣款。
  • 重试无退避:下游故障时压力叠加。

追问

  • 待确认:Ktor 3 客户端 Retry 插件配置条件与状态码规则,以官方文档核对。
  • 重试与熔断关系?答:重试控制单次故障恢复,熔断阻止持续打垮下游。

06.8.1.3-018 异步响应与并发调用如何组织?

一句话结论

客户端调用是挂起函数,可在协程内并发:async 并行发起多个下游调用再 await;并发度受信号量或连接池限制;依赖关系决定串行还是并行,子任务绑定请求作用域便于取消。

概念解释

并行调用减少总体等待,但并发度不能无限制放开。结构化并发保证请求取消时子调用一并取消。下游结果组合按成功/失败分支处理,部分失败要有兜底策略。

原理流程

  1. 识别可并行的下游调用。
  2. 在 coroutineScope 内 async 发起。
  3. await 组合结果。
  4. 失败按策略降级或抛出。

代码或图示

coroutineScope {
    val user = async { client.get<UserDto>("/users/1") }
    val orders = async { client.get<List<OrderDto>>("/users/1/orders") }
    user.await() to orders.await()
}

常见误区

  • 无控制地并发 fan-out:下游与自身连接池被打满。
  • 子任务脱离请求作用域:请求取消后仍在调用。

追问

  • 并发上限怎么控?答:信号量限流或按下游连接池容量设定。
  • 部分调用失败怎么办?答:按业务选择降级默认值或整体失败。

06.8.1.3-019 客户端异常类型与失败如何处理?

一句话结论

失败分网络异常(连接超时、断开)、响应错误状态码与反序列化异常;分别捕获分类处理:可重试网络错误有限重试,4xx 不重试,5xx 按策略降级;异常信息不直接暴露给最终用户。

概念解释

异常层次:调用层抛请求异常,状态错误由响应对象表达,解码失败是解析异常。分类处理避免把连接问题当业务失败。上层统一映射为自身错误结构与状态码,保留原始原因进日志。

原理流程

  1. 调用捕获网络/超时异常。
  2. 响应状态分支区分 4xx/5xx。
  3. body 解码异常单独处理。
  4. 映射为业务错误并记录日志。

代码或图示

try {
    client.get("/users/1")
} catch (e: HttpRequestTimeoutException) {
    // 超时降级
} catch (e: ResponseException) {
    // 错误状态码处理
}

常见误区

  • 所有异常都重试:4xx 被反复重试无意义。
  • 把下游原始错误消息透传给用户:泄露内部细节。

追问

  • 待确认:Ktor 3 客户端异常类型名称层次,以官方文档核对。
  • 响应体在异常里能取到吗?答:部分异常携带响应对象,按类型判断可读 body。

06.8.1.3-020 客户端资源如何关闭?

一句话结论

客户端实例持有连接池与线程,应用停机时调用 close 释放;实例关闭后不可再发请求;请求级响应体应消费完毕,否则连接无法归还;长生命周期实例绑定应用停止事件关闭。

概念解释

资源释放分两层:单次响应消费归还连接,实例关闭释放池与线程。后台协程持有的客户端引用在停机时一并取消。未关闭实例在容器退出时可能残留线程与连接。

原理流程

  1. 应用装配期创建实例。
  2. 请求消费响应体归还连接。
  3. 停机事件触发 client.close()。
  4. 等待连接与线程释放完成。

代码或图示

application.monitor.subscribe(ApplicationStopping) {
    apiClient.close()
}

常见误区

  • 服务退出不 close 客户端:连接与线程残留。
  • 关闭后仍有协程调用:失败异常。

追问

  • 待确认:close 是否带超时参数,以客户端文档核对。
  • 测试中如何避免实例泄漏?答:测试用例结束关闭实例或用测试上下文管理。

06.8.1.3-021 自定义请求头与公共头如何统一添加?

一句话结论

公共头在客户端 defaultRequest 统一附加(追踪标识、客户端版本、内容类型);单次请求需要覆盖时在请求 DSL 内设置;避免在每个调用点重复写公共头,敏感头不得进日志。

概念解释

公共头维度:调用方标识、trace 透传、默认 Accept/Content-Type。单次覆盖用于特殊接口。头命名与下游约定一致,大小写由 HTTP 头规则处理。公共头插件化统一管理便于审计。

原理流程

  1. 客户端配置 defaultRequest 附加公共头。
  2. 单次请求按需补充或覆盖。
  3. 出站插件链组装最终头。
  4. 日志输出前脱敏敏感头。

代码或图示

defaultRequest {
    header("X-Client-Id", clientId)
    accept(ContentType.Application.Json)
}

常见误区

  • 每个调用点手抄公共头:遗漏或不一致。
  • 覆盖默认头影响其他请求:单次作用域内修改。

追问

  • trace id 怎么透传?答:从当前请求属性取,放到出站头,见服务端追踪题目。
  • 待确认:defaultRequest API 名称在 Ktor 3 中的形式,以文档核对。

06.8.1.3-022 查询参数编码与路径拼接如何处理?

一句话结论

URL 路径段与查询参数通过 DSL 参数能力拼接,由客户端完成编码;不要手动拼接含特殊字符的串;多值参数按 DSL 重复添加;编码规则与下游框架保持兼容。

概念解释

手写拼接容易漏编码(空格、中文、&、=),导致参数截断或 400。DSL 区分路径段与查询参数分别编码。参数值中的保留字符由编码器转义,拼好的 URL 不再二次编码。

原理流程

  1. 基础 URL 模板定路径。
  2. 路径变量替换段值。
  3. 查询参数按名值添加并编码。
  4. 客户端组装最终请求行。

代码或图示

client.get("/search") {
    parameter("q", "Ktor 客户端")
    parameter("tag", "a")
    parameter("tag", "b")
}

常见误区

  • 手动字符串拼 ?q=$value:特殊字符未编码。
  • 对已编码值重复编码:参数变成乱码。

追问

  • 待确认:多值参数 DSL 写法,以客户端文档核对。
  • 路径段含空格/中文怎么办?答:作为路径变量由编码器处理,不要拼进原始模板。

06.8.1.3-023 下载文件与流式响应如何接收?

一句话结论

大文件用流式响应通道逐块读取写盘,不把整个 body 读进内存;读取循环处理背压与取消;完成后关闭流并释放临时文件;超时与大小限制按下载规模配置。

概念解释

小响应可整体读字节;文件下载应边读边写。流未读完连接无法归还池。取消请求时终止写入并清理临时文件。媒体类型与 Content-Disposition 头可用于判定文件名。

原理流程

  1. 发起下载请求。
  2. 通过流式通道分块读取。
  3. 逐块写入目标文件。
  4. 完成或取消时关闭流、清理临时文件。

代码或图示

val response = client.get<HttpStatement>("/files/report.pdf")
// 流式读取写入目标;具体流式 API 以客户端文档为准

常见误区

  • 大文件 readBytes() 全量入内存:OOM。
  • 流异常不关闭:临时文件与连接泄漏。

追问

  • 待确认:Ktor 3 客户端流式接收 API(通道/输出流)名称,以官方文档核对。
  • 断点续传支持吗?答:依赖下游 Range 支持,客户端按头与分块实现。

06.8.1.3-024 代理配置如何设置?

一句话结论

按引擎支持配置 HTTP/SOCKS 代理与凭据;代理配置绑定客户端实例,测试与生产环境代理不同时使用独立实例或环境配置;代理连接失败归入网络异常处理。

概念解释

企业内网常通过代理出站;代理地址、端口与凭据从环境配置注入,不写死代码。不同引擎代理实现能力不同,认证方式以引擎为准。直连与代理实例可按目标网络分组。

原理流程

  1. 从环境读取代理配置。
  2. 引擎层设置代理与凭据。
  3. 出站请求经代理转发。
  4. 代理失败按网络异常降级处理。

代码或图示

engine {
    // 代理配置按所选引擎 API;具体参数以引擎文档为准
}

常见误区

  • 代理凭据进源码仓库:泄露风险。
  • 生产/测试代理混用:环境网络不通。

追问

  • 待确认:各客户端引擎代理配置项,以引擎文档核对。
  • 绕过代理名单怎么配?答:按引擎支持的 no-proxy 规则配置。

06.8.1.3-025 HTTPS/TLS 与证书信任如何配置?

一句话结论

默认使用系统信任链校验服务端证书;自签内网证书需配置信任材料;不建议在生产关闭证书校验;TLS 版本与密码套件按安全基线配置,代理 TLS 终止位置要明确。

概念解释

TLS 校验防中间人:证书链、主机名有效期都应校验。关闭校验只应出现在受控测试环境。内网自签证书通过自定义信任库引入,证书随轮换更新。引擎 TLS 配置能力各有差异。

原理流程

  1. 确认链路 TLS 终止位置。
  2. 生产使用默认信任链或受控信任库。
  3. 配置最小 TLS 版本基线。
  4. 证书轮换后更新信任材料。

代码或图示

生产:证书链校验开启,不关闭 hostname 校验
测试:受控自签证书进入信任库

常见误区

  • 图省事关闭全部校验:中间人攻击敞口。
  • 内网证书过期未更新:调用批量失败。

追问

  • 待确认:Ktor 3 客户端引擎 TLS 定制 API,以官方/引擎文档核对。
  • 双向认证(mTLS)怎么配?答:客户端提供证书材料,按引擎 TLS 配置实现。

06.8.1.3-026 客户端拦截器如何改造请求与响应?

一句话结论

客户端插件/拦截器在出站前改请求(加头、改参数),入站后改响应(读状态、补充元数据);拦截包裹顺序由安装顺序决定;请求级修改不写入共享实例状态。

概念解释

与服务端管道同构:出站阶段、响应阶段包裹。典型用途:统一加追踪头、记录耗时、错误响应归一。拦截器内不能依赖单次请求的可变状态被其他调用看到。

原理流程

  1. 插件安装时注册出站/入站拦截。
  2. 出站前修改请求元数据。
  3. 调用执行。
  4. 入站后读取响应并补充处理。

代码或图示

// 示意:请求前加头,响应后记录耗时;具体钩子以插件 API 为准

常见误区

  • 在拦截器里缓存当前响应当全局状态:并发串数据。
  • 拦截器吞掉异常不记录:失败原因丢失。

追问

  • 待确认:客户端插件可用钩子与阶段名称,以官方文档核对。
  • 响应体能在拦截器重写吗?答:读取后可派生视图,已提交 body 不可回写,能力以实现为准。

06.8.1.3-027 后台/定时任务中使用客户端要注意什么?

一句话结论

后台协程复用应用级客户端实例,任务绑定应用生命周期;定时任务并发度受控,单次调用设超时与重试;任务异常独立记录,不影响其他任务;停机时取消任务并关闭客户端。

概念解释

后台任务与请求协程不同生命周期:随应用启动/停止。客户端实例共享但调用并发受配额限制。任务自身要有错误隔离、日志与告警,避免一次下游故障拖垮全部定时任务。

原理流程

  1. 应用启动注册后台任务 Job。
  2. 任务周期复用客户端发起调用。
  3. 并发、超时、重试受控。
  4. 停机取消任务,关闭客户端。

代码或图示

application.monitor.subscribe(ApplicationStarted) {
    // 启动后台调度;Job 注册到应用作用域
}

常见误区

  • 任务用 GlobalScope:停机取消不到。
  • 任务内新建客户端:资源泄漏与池浪费。

追问

  • 待确认:Ktor 3 应用启动事件名称,以官方文档核对。
  • 任务重叠执行怎么办?答:调度加互斥或上一次未完成则跳过/排队。

06.8.1.3-028 客户端与服务端如何共享序列化配置?

一句话结论

把 DTO 与 Json 配置抽到共享模块,服务端与客户端引用同一套:字段命名、未知键、日期格式一致;避免两端各配一套导致字段丢失或解析偏差;版本演进时共享模块统一升级。

概念解释

往返兼容是共享配置的核心:一端编码的字段另一端能解码。枚举、日期、空值策略尤其容易不一致。共享 DTO 模块同时被服务端与客户端依赖,版本跟随接口契约演进。

原理流程

  1. 抽取 DTO 与序列化配置到公共模块。
  2. 服务端接收/响应使用共享类型。
  3. 客户端请求/响应使用同一类型。
  4. 契约变更时统一升级两端。

代码或图示

// 共享模块:@Serializable data class UserDto(...)
val sharedJson = Json { ignoreUnknownKeys = true }

常见误区

  • 两端字段命名策略不同:响应字段对不上。
  • 一端允许未知键另一端严格:新版本字段解析失败。

追问

  • 待确认:项目内共享模块位置以实际工程结构为准,本节不指定仓库路径。
  • 接口多版本兼容怎么办?答:DTO 按版本分离,未知键策略显式约定。

06.8.1.3-029 连接泄漏与响应未消费有什么表现?

一句话结论

响应体未读取或流未关闭时,连接无法归还池,表现为连接数持续增长、池耗尽、新请求排队等待;排查看连接池指标、响应消费路径与异常中断路径是否关闭资源。

概念解释

连接复用要求 body 被消费或释放。异常分支、提前 return、流未关闭都会留下未释放连接。高并发下泄漏逐步累积,最终表现为请求超时而非即时报错。

原理流程

  1. 发起请求取得响应。
  2. 正常路径消费 body。
  3. 异常/提前退出路径未消费或未关闭。
  4. 连接滞留池中不可用,池耗尽。

代码或图示

排查:连接数曲线 / 池等待队列 / 响应读取代码路径 / 流关闭点

常见误区

  • 只在成功路径读 body:异常分支泄漏。
  • 流式读取循环被取消不关闭:连接与文件句柄残留。

追问

  • 如何验证响应被消费?答:压测观察连接归还与池空闲数,代码走查所有分支。
  • 待确认:客户端响应自动释放策略,以引擎实现核对。

06.8.1.3-030 客户端 API 与版本基线有哪些核对点?

一句话结论

升级或接入前核对:客户端引擎清单、插件坐标与配置项、请求/响应 DSL 方法名、异常类型层次、流式接收 API;不确定处标「待确认」,以 Ktor 3 官方文档与依赖仓库为准,不编造版本号。

概念解释

客户端 API 在大版本间有演进:插件拆分、钩子改名、引擎调整。核对路径:编译告警 -> 官方文档 -> 依赖坐标 -> 运行用例。答案中引用具体类名/属性前应确认版本。

原理流程

  1. 对齐 Ktor 3 与 Kotlin 2.x 基线。
  2. 查官方客户端文档确认引擎与插件。
  3. 核对 DSL 与异常类型签名。
  4. 用成功/超时/错误状态用例验证。

代码或图示

核对清单:引擎 / 插件坐标 / DSL 方法 / 异常类型 / 流式 API

常见误区

  • 凭旧版本笔记写 API 名:编译或运行期报错。
  • 只测成功路径:超时与错误状态未验证。

追问

  • 待确认:Ktor 3 客户端各插件确切坐标,以 ktor.io 文档为准。
  • 版本不兼容怎么处理?答:对齐基线版本,不混用跨大版本客户端依赖。

06.8.1.3-031 客户端压测关注哪些指标?

一句话结论

关注吞吐、P50/P95/P99 延迟、连接池占用、超时率与重试率;区分自身等待与下游耗时;按下游容量设定并发与超时,观察池排队与错误率拐点。

概念解释

客户端指标反映依赖调用健康:延迟分布比平均值重要,长尾影响整体接口 SLA。连接池占用与等待队列定位资源瓶颈;重试率高说明下游不稳定或超时过紧。

原理流程

  1. 压测场景覆盖典型报文与并发。
  2. 采集延迟分位、池占用、错误与重试。
  3. 找拐点:延迟随并发恶化的位置。
  4. 调整池、超时与并发上限。

代码或图示

指标:QPS / 延迟分位 / 连接池空闲与等待 / 超时率 / 重试率 / 错误状态分布

常见误区

  • 只看平均延迟:长尾请求被掩盖。
  • 压测不隔离下游:自身容量判断失真。

追问

  • 下游慢怎么隔离?答:舱壁池 + 超时 + 降级,避免拖垮主流程。
  • 待确认:客户端可观测指标暴露方式,以插件/引擎能力核对。

06.8.1.3-032 场景:调用第三方 API 的客户端如何装配?

一句话结论

按下游隔离独立客户端实例:配置专属超时、连接池、认证与序列化;凭据从配置注入;错误分类处理(重试/降级/告警);可观测指标与日志脱敏;停机统一关闭实例。

概念解释

第三方调用不稳定与策略特殊,隔离避免影响内部调用。装配包括引擎选择、超时分级、认证头、序列化兼容、重试熔断与指标。第三方契约(字段、错误码、限流)单独维护适配层。

原理流程

  1. 定义下游适配层与 DTO。
  2. 装配隔离客户端实例与策略。
  3. 调用封装分类处理与降级。
  4. 指标、日志与停机释放配套。

代码或图示

适配层:DTO 映射 -> 隔离客户端 -> 超时/重试/降级 -> 指标与脱敏日志

常见误区

  • 第三方与内部服务共用实例:池与超时互相拖累。
  • 透传第三方错误消息给用户:泄露与误导。

追问

  • 第三方限流怎么应对?答:自身并发配额 + 退避重试 + 降级,按对方配额调整。
  • 待确认:熔断组件在项目生态中的选型,按实际依赖核对。

06.8.1.3-033 服务端 WebSocket 路由如何注册?

一句话结论

在 routing 中用 webSocket 动词注册 WS 路由,闭包内获得会话对象处理收发;握手仍走常规 HTTP 管道,可挂认证与来源校验;路径参数与普通路由一致。

概念解释

WebSocket 路由节点与 HTTP 方法节点并列;升级成功后进入会话协程。注册位置决定握手前可套用的拦截(认证、CORS)。WS 路径与普通 HTTP 路径可共存于同一前缀。

原理流程

  1. routing 内 webSocket("/path") { 会话处理 }。
  2. 握手请求经过前置管道拦截。
  3. 升级成功建立会话。
  4. 闭包协程内收发消息直至关闭。

代码或图示

routing {
    webSocket("/ws") {
        // this: WebSocketSession
        send("connected")
    }
}

常见误区

  • 把 WS 会话当普通请求体读取:帧消息在会话通道内收发。
  • 握手认证挂在会话消息层:握手前未拦截。

追问

  • 待确认:Ktor 3 服务端 webSocket 注册 DSL 名称与会话类型,以官方文档核对。
  • WS 路径支持参数段吗?答:与普通路由一致,具体匹配行为以文档核对。

06.8.1.3-034 WebSocket 握手与 HTTP 是什么关系?

一句话结论

WebSocket 起始是一次 HTTP 升级请求:带升级头与协议版本,服务端同意后切换协议建立长连接;握手阶段可复用 HTTP 认证、CORS 与拦截管道,升级后帧通道独立于短请求管道。

概念解释

握手是 HTTP 语义,连接建立后是双向帧流。握手请求的头、来源、凭据可在升级前校验。代理与网关需要支持 Upgrade 头转发,否则握手失败。

原理流程

  1. 客户端发起带 Upgrade: websocket 的 HTTP 请求。
  2. 服务端管道校验认证与来源。
  3. 返回 101 切换响应,协议升级。
  4. 进入 WS 帧会话生命周期。

代码或图示

HTTP 握手(101 Switching Protocols) -> WebSocket 帧通道

常见误区

  • 网关不透传 Upgrade 头:握手被当普通 HTTP 处理失败。
  • 以为认证在每帧重复校验:握手通过后帧通道不再走 HTTP 认证管道。

追问

  • 待确认:101 响应与升级头的服务端行为,以引擎/WS 文档核对。
  • 握手失败返回什么?答:按 HTTP 错误状态拒绝,不建立会话。

06.8.1.3-035 会话对象与消息收发 API 是什么?

一句话结论

会话对象提供发送文本/二进制帧与接收帧流的能力;接收通常以通道或迭代形式消费,发送为挂起方法;会话持有连接状态,关闭后不可再收发。

概念解释

会话封装单个 WS 连接:发送方写帧,接收方读帧流。消息编解码在会话层完成(文本 JSON、二进制字节)。收发循环需处理帧类型、异常与关闭原因。具体 API 名称以版本为准。

原理流程

  1. 握手成功得到会话对象。
  2. 通过接收遍历读取入站帧。
  3. 业务处理后调用发送写出帧。
  4. 连接关闭会话结束。

代码或图示

webSocket("/ws") {
    incoming.consumeEach { frame ->
        when (frame) {
            is Frame.Text -> send("echo: ${frame.readText()}")
            is Frame.Binary -> /* 二进制处理 */
            else -> /* 控制帧 */
        }
    }
}

常见误区

  • 会话关闭后继续 send:抛异常或忽略。
  • 接收循环不处理异常:连接异常退出无清理。

追问

  • 待确认:入站消费 API(incoming/consumeEach)与帧类型在 Ktor 3 中的名称,以文档核对。
  • 会话能跨协程共享发送吗?答:写线程安全性需按实现核对,建议单一发送协调者。

06.8.1.3-036 WebSocket 帧类型有哪些?

一句话结论

帧分数据帧(文本、二进制)与控制帧(关闭、Ping、Pong);文本帧承载 UTF-8 文本消息,二进制帧承载任意字节;控制帧用于连接维持与关闭握手,业务消息只走数据帧。

概念解释

协议帧由类型标识与载荷组成。文本与二进制由业务约定用途;Ping/Pong 是心跳控制帧;关闭帧携带关闭原因码。应用层消息序列化(JSON/Protobuf)跑在文本或二进制帧之上。

原理流程

  1. 入站帧按类型分派。
  2. 文本帧解码为字符串/JSON。
  3. 二进制帧按约定格式解析字节。
  4. 控制帧由会话层处理心跳与关闭。

代码或图示

数据帧:Text / Binary
控制帧:Close / Ping / Pong

常见误区

  • 把业务消息塞进控制帧:协议用途错误。
  • 不区分文本与二进制解析:格式错乱。

追问

  • 待确认:Ktor 3 帧类型类名与读取 API,以官方 WS 文档核对。
  • 帧分片怎么处理?答:由会话层按协议重组,应用读到完整消息,能力以实现为准。

06.8.1.3-037 会话生命周期与关闭原因如何理解?

一句话结论

会话从握手成功开始,到正常关闭、对端关闭、网络断开或异常结束;关闭带原因码与可选描述;生命周期内的资源(订阅、关联状态)必须在结束时清理,避免幽灵会话。

概念解释

结束路径不止正常关闭:客户端断网、服务端重启、代理超时都会终止会话。服务端要在会话结束回调中移除在线集合、取消订阅、释放关联资源。关闭原因码用于区分正常退出与异常断开。

原理流程

  1. 握手成功加入会话管理。
  2. 收发循环处理消息。
  3. 收到关闭帧/异常/取消进入结束流程。
  4. 清理资源并从在线集合移除。

代码或图示

webSocket("/ws") {
    try {
        // 收发循环
    } finally {
        // 移除会话、取消订阅
    }
}

常见误区

  • 只处理正常关闭:异常断开会话残留在在线集合。
  • 会话结束不清理订阅:消息推给已关闭连接。

追问

  • 待确认:会话结束回调与关闭原因读取 API,以官方文档核对。
  • 断线后会话状态保留多久?答:重新连接后按业务标识恢复,不依赖旧会话对象。

06.8.1.3-038 心跳 Ping/Pong 如何配置?

一句话结论

心跳通过周期性 Ping 帧与 Pong 响应检测存活;服务端或客户端一方发起,配置间隔与超时;超时未收到 Pong 判定断线并清理会话;心跳间隔按连接存活需求与代理超时调整。

概念解释

长连接在空闲时没有业务帧,需要心跳识别半死连接(网络中断但 TCP 未通知)。心跳间隔要短于代理/网关的空闲断开时间。Pong 应答由协议层自动或应用层处理,按实现核对。

原理流程

  1. 配置心跳间隔与等待超时。
  2. 空闲时发送 Ping。
  3. 等待 Pong,超时判定断线。
  4. 关闭并清理会话。

代码或图示

心跳:Ping 间隔 < 代理空闲超时;Pong 超时 -> 判定死连接

常见误区

  • 心跳间隔长于代理断开:连接被中间层静默关闭。
  • 心跳任务不随会话取消:会话结束后仍发 Ping。

追问

  • 待确认:Ktor 3 心跳配置入口与自动 Pong 行为,以官方文档核对。
  • 心跳消息算业务流量吗?答:控制帧不计业务消息量。

06.8.1.3-039 断线与异常如何处理?

一句话结论

收发循环捕获连接异常与协程取消,进入统一结束流程:移除会话、取消订阅、记录断开原因;异常分类区分客户端主动退出、网络中断与服务端错误,避免一个异常拖垮会话管理。

概念解释

异常来源:网络读写失败、对端异常关闭、消息解析错误、会话取消。处理原则:任何退出路径都走同一清理流程;解析错误可单帧忽略,连接错误终止会话。日志记录会话标识与原因,不记敏感消息。

原理流程

  1. 循环内捕获异常与取消。
  2. 分类判断:解析错误/连接错误/主动关闭。
  3. 统一清理关联资源。
  4. 记录日志并通知上层会话状态变更。

代码或图示

try {
    incoming.consumeEach { /* ... */ }
} catch (e: Throwable) {
    // 记录断开原因,不抛出导致管理协程崩溃
} finally {
    cleanup()
}

常见误区

  • 异常未捕获导致会话管理协程崩溃:后续连接受影响。
  • 解析错误直接断连:单条坏消息不应杀掉整个连接。

追问

  • 待确认:会话异常类型与取消传播行为,以源码/文档核对。
  • 断线重连由谁负责?答:客户端侧重连,服务端识别重连后的身份恢复状态。

06.8.1.3-040 会话状态如何管理(在线集合)?

一句话结论

服务端用线程安全集合维护会话标识到会话的映射,按用户/租户分组;会话结束时移除;集合只存必要引用,不存大对象;多实例下会话分布在各节点,广播需经消息中间件跨节点。

概念解释

在线集合支撑点对点推送与在线状态展示。并发连接增减必须用并发集合或加锁;会话引用泄漏会阻止会话对象回收。单节点集合无法跨实例推送,分布式场景用订阅消息队列同步。

原理流程

  1. 握手成功按身份加入集合。
  2. 业务推送从集合取会话。
  3. 会话结束从集合移除。
  4. 多实例经中间件发布消息到目标节点。

代码或图示

val sessions = ConcurrentHashMap<String, MutableSet<WebSocketSession>>()

常见误区

  • 用普通 ArrayList 存会话:并发增减竞态。
  • 会话结束不移除:集合膨胀、推送幽灵连接。

追问

  • 待确认:项目在线状态是否走外部存储,按架构设计核对。
  • 一个用户多设备连接怎么管?答:按用户标识维护会话集合,推送遍历全部设备。

06.8.1.3-041 广播与点对点消息推送如何实现?

一句话结论

点对点按用户标识从会话集合取目标会话发送;广播遍历全部在线会话或按分组筛选;发送失败(连接已断)触发移除;多实例广播通过消息中间件分发到各节点本地会话。

概念解释

推送路由:业务事件 -> 查找在线会话 -> 发送帧。发送前检查会话存活,发送异常即清理。广播注意消息量与连接数关系,必要时分批与限速。订阅关系(频道、群组)在会话管理层维护。

原理流程

  1. 业务事件携带目标标识或分组。
  2. 本地集合查会话;跨节点经中间件投递。
  3. 遍历发送,失败标记移除。
  4. 订阅变更时更新分组关系。

代码或图示

点对点:userId -> sessions[userId]
广播:事件 -> 节点本地全部会话 / 分组订阅集合

常见误区

  • 对已关闭会话发送不捕获异常:推送协程中断。
  • 单节点集合做全量广播:多实例用户收不到。

追问

  • 推送顺序有要求吗?答:同会话内按顺序发送,跨会话不保证全局顺序。
  • 待确认:项目推送通道(WS/SSE/中间件)选型,按架构核对。

06.8.1.3-042 消息编解码与 JSON 序列化如何配合?

一句话结论

文本帧内约定 JSON(或其他编码)消息结构,收发时用共享序列化配置编解码;消息包带类型标识便于分派;解码失败返回错误帧或忽略,不抛出断开连接;DTO 与客户端/前端共享契约。

概念解释

WS 帧本身不定义消息格式,应用层自选 JSON/Protobuf/文本协议。消息分派按 type 字段路由到处理器。序列化配置与 HTTP 接口保持一致,枚举、日期、空值策略统一。

原理流程

  1. 定义消息信封(类型、标识、载荷)。
  2. 入站文本帧反序列化为信封。
  3. 按类型分派处理器。
  4. 出站对象序列化为文本帧发送。

代码或图示

@Serializable
data class WsEnvelope(val type: String, val payload: String? = null)

常见误区

  • 消息无类型标识:分派靠猜测,扩展困难。
  • 解码异常直接断连:单条坏消息影响长连接。

追问

  • 二进制帧选什么格式?答:Protobuf 等紧凑格式,按项目契约约定。
  • 待确认:WS 会话内序列化复用 ContentNegotiation 配置的方式,以文档核对。

06.8.1.3-043 并发写会话需要注意什么?

一句话结论

同一会话的发送应通过单一协调者串行化,避免多协程并发写导致帧交错;不同会话可并发发送;发送前检查存活状态,写异常触发清理;共享订阅回调向会话写消息要走同步队列。

概念解释

WS 帧通道对并发写的安全性依实现而定,保守做法是每会话一个发送协程或加锁。业务事件回调可能来自不同线程/协程,提交到会话队列由发送协程消费。帧交错会破坏消息边界。

原理流程

  1. 每会话维护消息队列与发送协程。
  2. 事件回调入队,不直接写帧。
  3. 发送协程串行出队发送。
  4. 关闭时停止队列并清理。

代码或图示

事件回调 -> 会话队列 -> 单一发送协程 -> 帧写出

常见误区

  • 多个业务协程直接并发 send:帧交错损坏消息。
  • 发送不检查存活:向关闭连接写异常。

追问

  • 待确认:Ktor 3 会话 send 的并发安全性,以源码/文档核对。
  • 队列满了怎么办?答:按策略丢弃旧消息或背压控制,避免内存膨胀。

06.8.1.3-044 WebSocket 与 SSE 如何取舍?

一句话结论

双向实时交互选 WebSocket;服务端单向推送、客户端只读消息选 SSE;SSE 基于普通 HTTP,实现简单、自动重连友好,受代理缓冲与浏览器特性限制;双向写需求不能用 SSE 替代。

概念解释

SSE 是服务器到客户端的单向文本流;WebSocket 全双工。选型看交互方向、代理兼容性、实现成本与重连需求。消息格式两者都是文本为主,SSE 有事件格式与标识约定。

原理流程

  1. 判断是否需要客户端实时上行。
  2. 仅下行推送:评估 SSE。
  3. 双向交互:选 WebSocket。
  4. 核对代理与浏览器兼容后定稿。

代码或图示

WebSocket:双向、二进制可、自定义协议
SSE:单向下行、HTTP 流、事件标识与自动重连

常见误区

  • 用 SSE 做客户端实时上报:方向不匹配,仍需另开 HTTP。
  • 复杂双向协议硬塞 SSE:轮询兜底导致实时性差。

追问

  • 待确认:项目对 SSE 客户端支持范围,按目标浏览器/环境核对。
  • 两者能并存吗?答:可按场景分通道,服务端分别实现。

06.8.1.3-045 客户端 WebSocket 如何连接?

一句话结论

客户端用 WS 客户端工厂建立连接:指定 URL、握手头与子协议,连接成功得到会话对象;连接失败按网络异常处理;生命周期与调用协程绑定,结束时关闭会话。

概念解释

客户端 WS 握手同样是 HTTP 升级,可携带认证头。连接配置包含超时、心跳、重连策略。会话对象用于收发,协程取消时连接关闭。具体工厂与 API 名称以版本为准。

原理流程

  1. 创建 WS 客户端或复用客户端实例。
  2. 发起连接,带握手头与子协议。
  3. 握手成功进入会话协程。
  4. 收发循环,结束关闭连接。

代码或图示

client.webSocket(path = "/ws") {
    send("hello")
    incoming.consumeEach { /* ... */ }
}

常见误区

  • 连接协程不结束:会话保持泄漏。
  • 握手认证头漏带:握手阶段被拒绝。

追问

  • 待确认:Ktor 3 客户端 webSocket 扩展与会话类型,以官方文档核对。
  • WS 客户端复用 HTTP 客户端实例吗?答:按实现可复用配置,连接独立管理,以文档核对。

06.8.1.3-046 客户端会话收发循环如何组织?

一句话结论

连接后在协程内并行处理:发送循环消费出站消息队列,接收循环读入站帧;两者随会话结束退出;分派入站消息到业务处理器,出站消息从业务事件队列取。

概念解释

双向通道需要两条处理线:收与发可在同一协程内交替,或拆分两个子协程。结构化并发保证任一方结束都能取消另一方。消息编解码在循环边界完成,业务逻辑不接触帧细节。

原理流程

  1. 连接成功启动收发协程。
  2. 接收循环读取帧并分派。
  3. 发送循环取出站队列写帧。
  4. 关闭/异常时两条线一并退出。

代码或图示

webSocket("/ws") {
    launch { outgoing.consumeEach { send(it) } }
    incoming.consumeEach { handle(it) }
}

常见误区

  • 收发混在单循环阻塞:出站消息被接收等待卡住。
  • 子协程脱离会话作用域:结束后残留。

追问

  • 待确认:会话内启动子协程的作用域约束,以源码核对。
  • 消息顺序怎么保证?答:单连接内按帧顺序,出站队列保证发送次序。

06.8.1.3-047 客户端心跳与断线重连如何配合?

一句话结论

心跳保活检测死连接;断线后按退避策略重连,重连前重新握手认证;重连期间消息做排队或丢弃策略;指数退避加抖动避免雪崩,连接恢复后恢复订阅与状态同步。

概念解释

重连是客户端职责:检测断开 -> 等待退避 -> 重新连接 -> 恢复会话状态。心跳超时与读写异常都触发重连。连续失败次数有限制,超过后上报告警。重连不要立刻疯狂重试。

原理流程

  1. 心跳维持连接存活。
  2. 检测断线(异常/超时/关闭帧)。
  3. 退避等待后重新握手。
  4. 恢复订阅、补拉缺失状态。

代码或图示

断线 -> 退避(指数+抖动) -> 重连握手 -> 状态恢复 -> 继续收发

常见误区

  • 断线立即重连:服务端故障时重试风暴。
  • 重连不重新认证:凭据过期后握手失败。

追问

  • 待确认:Ktor WS 客户端是否内置心跳与重连配置,以文档核对;多数场景需自实现重连循环。
  • 重连期间上行消息怎么办?答:按业务选择短暂排队或丢弃,避免无限积压。

06.8.1.3-048 重连退避策略怎么设计?

一句话结论

指数退避:间隔随失败次数翻倍,加随机抖动打散并发重连;设最大间隔与重试上限;连接成功重置计数;区分可重连网络错误与不可重连业务拒绝(如认证失败不重试)。

概念解释

退避保护故障中的服务端:避免大量客户端同步重试。抖动让重连时刻分散。认证失败、协议错误等不应重连;网络抖动、服务端重启属于可重试场景。上限后进入告警人工介入。

原理流程

  1. 断线分类:可重试/不可重试。
  2. 可重试:计算退避间隔(指数 + 抖动)。
  3. 等待后重连,成功重置计数。
  4. 超过上限停止重试并告警。

代码或图示

delay = min(base * 2^attempt, maxDelay) + randomJitter

常见误区

  • 固定间隔重试:故障期同步冲击。
  • 对 401/403 握手失败无限重连:凭据问题需人工介入。

追问

  • 群组客户端同时重连怎么办?答:抖动 + 限速,服务端配合限流。
  • 退避状态存哪里?答:客户端连接管理对象内,随应用生命周期。

06.8.1.3-049 子协议与握手头如何处理?

一句话结论

WebSocket 子协议在握手时通过 Sec-WebSocket-Protocol 协商,服务端选定后双方按该协议通信;自定义握手头携带认证、追踪标识等;子协议与消息格式契约保持一致。

概念解释

子协议让同一通道承载约定格式(如 chat、rpc 版本)。握手头只在升级请求中出现,连接建立后不重复携带。认证信息在握手阶段校验,后续帧不再走 HTTP 头。

原理流程

  1. 客户端握手提交支持的子协议列表与头。
  2. 服务端选定子协议并回握手响应。
  3. 双方按选定协议编解码。
  4. 业务消息遵循协议契约。

代码或图示

握手:Sec-WebSocket-Protocol 协商 + 自定义认证/追踪头

常见误区

  • 连接建立后再想加握手头:已无法补充,需重连。
  • 子协议版本两端不一致:消息解析错乱。

追问

  • 待确认:Ktor 3 子协议配置与读取 API,以官方文档核对。
  • 多版本协议兼容怎么做?答:子协议标识版本,服务端按版本分派处理器。

06.8.1.3-050 二进制帧如何处理?

一句话结论

二进制帧载荷为字节,按约定格式(Protobuf、自定义二进制)解析;读取前校验长度与格式;二进制比文本紧凑,适合高频消息;编解码库选择与跨端契约配套。

概念解释

二进制帧不强制 UTF-8;应用层格式自定。解析失败要能定位坏帧,不拖垮连接。与文本帧相比体积小但可读性差,调试时需转码查看。消息信封仍需类型与版本标识。

原理流程

  1. 接收 Binary 帧取得字节载荷。
  2. 按约定格式反序列化。
  3. 校验类型与版本。
  4. 出站对象序列化为二进制帧发送。

代码或图示

is Frame.Binary -> {
    val bytes = frame.readBytes()
    // 按 Protobuf 等格式解析
}

常见误区

  • 二进制载荷当文本解码:乱码与解析异常。
  • 不校验长度:恶意大帧占用内存。

追问

  • 待确认:帧字节读取 API 名称,以文档核对。
  • 文本与二进制能混用吗?答:协议约定为主,混用需消息类型区分。

06.8.1.3-051 客户端会话关闭与资源释放怎么做?

一句话结论

主动关闭发送关闭帧并等待对端响应;协程取消时强制释放连接;出站队列、订阅回调与缓冲消息在结束时清理;关闭异常记录但不抛出到管理上层。

概念解释

关闭分主动优雅关闭与异常断开。优雅关闭走协议关闭握手;异常路径直接释放套接字。关联资源(队列、订阅、状态订阅)在 finally 中清理,避免客户端侧泄漏。

原理流程

  1. 业务结束或检测断线。
  2. 优雅关闭:发 Close 帧等待响应。
  3. 取消收发子协程。
  4. 清理队列与订阅,释放连接。

代码或图示

try {
    // 收发循环
} finally {
    outgoing.cancel()
    // 取消订阅回调
}

常见误区

  • 只关闭套接字不等关闭握手:对端状态不一致。
  • 队列回调持有会话引用:连接释放不掉。

追问

  • 待确认:关闭帧发送与原因码 API,以官方文档核对。
  • 重连前旧会话资源是否清理干净?答:必须先完成旧会话清理再建新连接。

06.8.1.3-052 WebSocket 连接鉴权怎么做?

一句话结论

认证在握手请求阶段完成:凭据通过握手头、Cookie 或握手前的临时票据携带;握手通过后建立会话,帧通道内不再重复 HTTP 认证;会话内角色与权限由握手产出的主体携带。

概念解释

握手是唯一的 HTTP 语义阶段,认证拦截器在此生效。凭据形式:Bearer 头、Cookie、一次性握手票据(避免 URL 带令牌进日志)。连接建立后切换到会话主体,后续操作按主体授权。

原理流程

  1. 握手请求携带凭据。
  2. 前置认证拦截校验并产出主体。
  3. 握手通过,主体绑定会话。
  4. 帧消息按会话主体授权。

代码或图示

握手:认证头/Cookie/票据 -> 校验 -> 主体绑定会话
帧阶段:按主体授权,不再走 HTTP 认证管道

常见误区

  • 令牌放 URL 查询参数:进访问日志与代理记录。
  • 握手通过后不在帧层做权限校验:依赖连接时的身份即可,但权限变更需重连生效。

追问

  • 待确认:握手阶段复用 Authentication 插件的方式,以官方文档核对。
  • 长连接期间权限变更怎么办?答:重连刷新主体,或会话内定期校验。

06.8.1.3-053 消息背压与消费速度如何处理?

一句话结论

消费慢于生产时需要背压控制:限制出站/入站队列长度,溢出按策略丢弃或阻塞;慢消费者不影响其他连接;消息积压指标监控,避免内存随连接数膨胀。

概念解释

WS 是长连接,消息速率不匹配会形成队列积压。背压手段:有界队列、发送慢时降低生产速率、非关键消息丢弃。每条会话独立队列,避免单消费者拖垮全局。

原理流程

  1. 每会话队列设上限。
  2. 入站/出站超阈值执行策略。
  3. 监控积压深度与丢弃数。
  4. 慢消费者反馈到生产限速。

代码或图示

队列有界:满 -> 丢弃旧消息 / 阻塞生产 / 断开策略

常见误区

  • 无界队列缓存消息:慢连接拖垮服务端内存。
  • 一条慢连接占用全局消费者:其他连接排队。

追问

  • 待确认:Ktor WS 通道是否提供队列容量配置,以文档核对。
  • 关键消息能丢吗?答:按业务分级,关键消息需持久化或重传机制。

06.8.1.3-054 WebSocket 相关 API 有哪些待核对点?

一句话结论

接入前核对:服务端/客户端 WS 注册与扩展方法名、会话类型与收发 API、帧类型读取、心跳配置、子协议协商、关闭原因码与异常类型;不确定处标待确认,以 Ktor 3 官方文档为准。

概念解释

WS API 在版本间可能调整扩展函数名与会话接口。核对清单按握手、收发、控制帧、生命周期四块组织。代码引用具体符号前先编译与文档双重确认。

原理流程

  1. 对齐 Ktor 3/Kotlin 基线。
  2. 查官方 WS 文档核对符号。
  3. 编译验证 unresolved 告警。
  4. 用连接、收发、关闭用例运行验证。

代码或图示

核对块:握手注册 / 会话收发 / 帧类型 / 心跳 / 子协议 / 关闭与异常

常见误区

  • 凭旧版本笔记写扩展函数名:编译失败。
  • 假设心跳自动开启:默认行为需核对。

追问

  • 待确认:确切符号清单见 ktor.io WS 章节,升级版本时复核。
  • 引擎对 WS 支持有差异吗?答:连接升级与并发行为依引擎实现核对。

06.8.1.3-055 SSE 服务端如何推送事件?

一句话结论

SSE 在单个 HTTP 响应中保持文本流,按事件格式(事件类型、数据、标识、重试间隔)逐行写出;响应不关闭,服务端持续写事件;客户端按流读取,适合单向下行推送。

概念解释

SSE 响应 Content-Type 为 event-stream,事件以 data: 等字段行组织,空行分隔事件。服务端把业务事件写入响应通道;连接生命周期对应一次 HTTP 请求。事件标识用于断点重连。

原理流程

  1. 客户端发起 SSE 连接请求。
  2. 服务端设置 event-stream 响应头。
  3. 业务事件到达时格式化写入流。
  4. 连接关闭结束本次推送。

代码或图示

event: message
data: {"k":"v"}
id: 42
retry: 3000

常见误区

  • 按普通 JSON 响应一次性写出:无法持续推送。
  • 响应缓冲未关闭:事件被代理攒批不能实时到达。

追问

  • 待确认:Ktor 3 SSE 支持方式(原生插件或流式响应实现),以官方文档核对。
  • 事件格式错误会怎样?答:客户端解析失败或事件边界错乱。

06.8.1.3-056 SSE 与 WebSocket 差异体现在哪些方面?

一句话结论

SSE 单向下行、基于 HTTP 文本流、自带重连标识;WebSocket 全双工、协议升级、可二进制;实现复杂度、代理友好度与交互方向决定选型,二者实时性目标不同。

概念解释

差异维度:方向、协议、消息格式、重连机制、代理/缓存兼容、浏览器支持。SSE 不适合客户端实时上行;WebSocket 实现与运维复杂度更高。同一系统可按场景分别使用。

原理流程

  1. 列交互方向与消息格式需求。
  2. 评估代理缓冲与浏览器兼容。
  3. 对比实现与重连成本。
  4. 选定通道或组合使用。

代码或图示

SSE:单向 / HTTP 流 / 文本 / Last-Event-ID 重连
WS:双向 / 协议升级 / 文本+二进制 / 自行重连

常见误区

  • 把 SSE 当 WS 简化版替代双向场景:上行能力缺失。
  • 忽视代理对 SSE 流的缓冲:推送延迟。

追问

  • 待确认:目标环境代理是否透传 event-stream,按部署网关核对。
  • SSE 能传二进制吗?答:文本编码(如 base64)可携带,效率低于 WS 二进制。

06.8.1.3-057 SSE 重连与 Last-Event-ID 如何工作?

一句话结论

每个事件带 id,断线重连时客户端在请求头携带 Last-Event-ID,服务端据此补发该标识之后的事件;服务端需维护可回溯的事件存储或接受少量重复;无状态推送可跳过补发。

概念解释

重连标识解决断线期间消息缺口。服务端能力分三种:不补发、内存窗口补发、持久化日志补发。事件 id 单调递增,补发区间按 id 计算。重复事件由客户端按 id 去重。

原理流程

  1. 推送事件写入 id。
  2. 断线后客户端带 Last-Event-ID 重连。
  3. 服务端查该 id 之后的事件补发。
  4. 客户端去重并继续消费。

代码或图示

事件 id: 单调递增
重连:Last-Event-ID -> 服务端补发区间 -> 客户端按 id 去重

常见误区

  • 事件 id 不单调:补发区间无法计算。
  • 不做重复处理:补发事件被重复渲染。

追问

  • 待确认:Ktor 服务端读取 Last-Event-ID 的方式,按请求头读取实现。
  • 事件存储保留多久?答:按重连窗口要求设定,过期后从最新状态同步。

06.8.1.3-058 客户端如何消费 SSE?

一句话结论

客户端打开 event-stream 连接,按行解析事件字段(event/data/id/retry),空行分隔完成一个事件;分派事件类型到处理器;断线按 retry 与 Last-Event-ID 重连;消费循环随连接结束退出。

概念解释

SSE 解析是文本行状态机:累积行缓冲,遇到空行组装事件。浏览器原生 EventSource 自动重连,自实现客户端需处理重连与标识。错误与连接关闭事件单独处理。

原理流程

  1. 发起 SSE 请求并保持响应流。
  2. 逐行读取事件字段。
  3. 空行触发事件分派。
  4. 断线带 Last-Event-ID 重连。

代码或图示

行缓冲 -> 字段解析 -> 空行成事件 -> 分派处理器

常见误区

  • 按完整 JSON 一次性读取:流事件被攒批。
  • 不处理多行 data:事件载荷截断。

追问

  • 待确认:Ktor 客户端 SSE 消费 API 是否内置,以官方文档核对;否则按流式响应自行解析。
  • 浏览器 EventSource 限制?答:连接数、头定制能力受浏览器规范约束。

06.8.1.3-059 SSE 有哪些兼容性与代理缓冲问题?

一句话结论

部分代理/网关默认缓冲响应,导致 SSE 事件不能实时下发,需关闭缓冲或按流式透传;浏览器对 EventSource 连接数与自定义头有限制;HTTPS 与重连行为受中间层影响,部署时需验证端到端延迟。

概念解释

缓冲是 SSE 最常见部署问题:Nginx/网关按响应缓冲攒批。透传配置包括关闭 buffering、设置正确 Content-Type 与不压缩流式响应。浏览器侧连接上限与鉴权头限制影响接入方案。

原理流程

  1. 部署链路核对代理缓冲配置。
  2. 确保流式响应不被压缩/缓存攒批。
  3. 验证端到端事件延迟。
  4. 浏览器限制在方案设计时规避。

代码或图示

排查:事件延迟 -> 代理 buffering / 压缩 / 缓存策略 / 连接数上限

常见误区

  • 本地直连正常就上线:网关缓冲在生产才暴露。
  • 对 SSE 响应启用压缩:缓冲与实时性受损。

追问

  • 待确认:项目网关 SSE 透传配置项,按实际代理核对。
  • 连接数上限怎么办?答:合并推送通道或改用 WS,按浏览器/环境限制评估。

06.8.1.3-060 SSE 适用场景是什么?

一句话结论

适合服务端单向推送:通知、行情增量、进度更新、状态广播;客户端不需要实时上行、消息以文本事件为主、可接受断线重连补齐的场景;双向交互或高频二进制消息选 WebSocket。

概念解释

场景匹配看方向、频率、格式与重连要求。内部进度条、公告推送类用 SSE 实现成本低;聊天、协作编辑、实时控制类双向场景用 WS。也可 SSE 下行 + 普通 HTTP 上行组合。

原理流程

  1. 梳理消息方向与频率。
  2. 评估文本格式与重连补齐需求。
  3. 匹配 SSE 能力边界。
  4. 不匹配则选 WS 或组合方案。

代码或图示

SSE:通知 / 进度 / 行情 / 状态广播
WS:聊天 / 协作 / 双向控制 / 高频二进制

常见误区

  • 低频单向推送也上 WS:运维复杂度不必要。
  • 上行简单请求也走 WS:HTTP 接口足够。

追问

  • 待确认:项目实时消息通道选型记录,按架构文档核对。
  • 混合架构怎么切?答:SSE 下行通知 + HTTP 上报,按消息类型分通道。

06.8.1.3-061 testApplication 如何构造测试?

一句话结论

testApplication 装配模块函数构造测试环境,提供测试客户端发起请求;不绑定真实端口与网络栈,在内存管道中推进;依赖替换为测试替身,断言响应行为。

概念解释

测试应用复用生产模块装配逻辑,替换外部依赖。测试上下文管理应用生命周期与清理。测试用例通过客户端请求驱动 Handler,覆盖路由、认证与插件行为。具体 API 名称以版本为准。

原理流程

  1. 调用 testApplication 装配模块。
  2. 注入测试替身依赖。
  3. 测试客户端发起请求。
  4. 断言响应并清理测试状态。

代码或图示

testApplication {
    val response = client.get("/health")
    assertEquals(HttpStatusCode.OK, response.status)
}

常见误区

  • 测试连真实外部服务:用例不稳定且污染数据。
  • 复制生产装配到测试:配置与生产漂移。

追问

  • 待确认:Ktor 3 testApplication 入口与客户端访问方式,以官方测试文档核对。
  • 测试能启动真实引擎吗?答:默认内存环境;需要引擎级验证时另起集成测试。

06.8.1.3-062 测试客户端如何发请求并断言?

一句话结论

测试客户端支持 get/post 等方法,携带头、参数与 body;断言状态码、响应头与反序列化 body;错误响应同样读取断言;请求 DSL 与生产客户端用法一致。

概念解释

断言分状态层与内容层:状态码、头、body 结构。body 按类型反序列化后比对字段。测试覆盖成功、参数非法、未认证等分支,断言错误结构与错误码。

原理流程

  1. 构造请求方法、路径与载荷。
  2. 发起调用取得响应。
  3. 断言状态码与头。
  4. 解析 body 断言字段。

代码或图示

val res = client.post("/users") {
    contentType(ContentType.Application.Json)
    setBody(NewUser(name = "Ann"))
}
assertEquals(HttpStatusCode.Created, res.status)

常见误区

  • 只断言状态码不验 body:响应内容错误未发现。
  • 测试依赖真实时间/随机值:断言不稳定。

追问

  • 待确认:测试客户端 body 读取与反序列化 API,以文档核对。
  • 如何断言 JSON 字段?答:反序列化 DTO 比对,或读取文本校验结构。

06.8.1.3-063 如何测试路由参数与请求体?

一句话结论

路径参数与查询参数通过请求 URL 传入,断言 Handler 解析结果;请求体按 DTO 提交,覆盖合法、缺失字段、类型错误与非法值用例;参数校验失败断言 400 与错误结构。

概念解释

参数测试验证路由匹配与校验边界:合法值进入业务,非法值被入口拦截。用例覆盖路径段、查询串、表单与 JSON body。解析失败的响应结构与字段错误列表同样断言。

原理流程

  1. 准备合法与非法参数用例。
  2. 发起对应请求。
  3. 断言成功响应或 400 错误。
  4. 核对校验字段与错误码。

代码或图示

val ok = client.get("/users/1")
val bad = client.get("/users/abc")
assertEquals(HttpStatusCode.BadRequest, bad.status)

常见误区

  • 只测合法路径:校验分支未覆盖。
  • 路径编码场景遗漏:中文/特殊字符参数未验证。

追问

  • 如何断言请求被正确解析?答:通过业务响应或测试替身记录入参间接验证。
  • 嵌套 body 校验怎么测?答:逐字段提交缺失/非法值,断言字段级错误。

06.8.1.3-064 如何测试认证保护路径?

一句话结论

对每个受保护路由分别发起匿名、无效凭据与有效凭据请求:匿名/无效断言 401/403,有效断言放行;主体角色与数据归属分支同样覆盖;枚举受保护清单避免漏测。

概念解释

认证测试必须包含负向用例:未带凭据、过期/伪造令牌、无权限角色。只测登录态会漏掉未保护接口。测试替身可构造主体,避免依赖真实认证服务。

原理流程

  1. 列出受保护路由清单。
  2. 匿名与无效凭据请求断言拒绝。
  3. 有效主体请求断言放行。
  4. 越权主体断言 403。

代码或图示

assertEquals(HttpStatusCode.Unauthorized, client.get("/me").status)
val authed = client.get("/me") { header("Authorization", "Bearer $valid") }
assertEquals(HttpStatusCode.OK, authed.status)

常见误区

  • 测试客户端默认带认证头:负向用例被污染。
  • 只测一个代表接口:其余路由漏保护。

追问

  • 待确认:测试环境如何构造 principal 替身,以认证插件测试方式核对。
  • 会话 Cookie 怎么测?答:测试客户端携带会话头/Cookie,断言会话行为。

06.8.1.3-065 MockEngine 的用途与边界是什么?

一句话结论

MockEngine 替换真实网络引擎,在客户端测试中拦截请求并返回预设响应,用于验证客户端插件、请求构造与错误处理;不测试真实网络行为,连接池与 TLS 等引擎能力不在其覆盖范围。

概念解释

单元测试客户端逻辑时,MockEngine 按请求匹配返回状态、头与 body,避免依赖外部服务。它验证出站请求构造(方法、URL、头、body)与响应处理分支;真实网络兼容仍需集成测试。

原理流程

  1. 客户端构造时注入 MockEngine。
  2. 配置请求匹配到预设响应。
  3. 调用触发 Mock 响应。
  4. 断言请求构造与响应处理。

代码或图示

val client = HttpClient(MockEngine) {
    // MockEngine 配置按官方测试文档
}

常见误区

  • 用 MockEngine 验证超时/连接池:引擎行为未真实执行。
  • Mock 响应与真实契约不一致:集成时暴露问题。

追问

  • 待确认:Ktor 3 MockEngine 配置与请求拦截 API,以官方测试文档核对。
  • 什么测试需要真实引擎?答:端到端网络、TLS、连接复用验证。

06.8.1.3-066 如何注入测试替身依赖?

一句话结论

模块函数接收依赖工厂或接口,测试装配时替换为内存实现、Mock 桩;替身实现同一接口,记录调用参数并返回预设数据;外部消息、缓存、时间等边界都可替身化。

概念解释

可测试性来自依赖倒置:业务依赖接口,生产注入真实实现,测试注入替身。替身分类:返回固定数据的桩、记录调用的 Mock、模拟失败的故障实现。装配入口统一,不通过全局查找。

原理流程

  1. 生产模块定义依赖接口参数。
  2. 测试装配传入替身实现。
  3. 用例断言替身收到的调用。
  4. 模拟下游失败验证降级分支。

代码或图示

fun Application.configureUsers(repository: UserRepository) { /* ... */ }
// 测试:configureUsers(InMemoryUserRepository)

常见误区

  • 服务内硬编码 new 真实客户端:测试无法替换。
  • 替身不模拟失败路径:降级与重试分支未覆盖。

追问

  • 时间/随机数怎么替身?答:抽象时钟与随机源接口,测试注入固定值。
  • 消息队列替身怎么做?答:内存实现收发接口,断言发布消息。

06.8.1.3-067 如何测试异常映射与状态码?

一句话结论

触发领域异常与反序列化错误,断言映射后的状态码、错误码与响应结构;覆盖未预期异常兜底 500;日志记录断言不强制,但异常分类必须可区分。

概念解释

异常映射测试验证 StatusPages 与错误归一:业务异常 -> 对应 4xx,系统异常 -> 500。错误 body 的字段错误列表、中性消息格式断言。测试替身抛出指定异常触发映射链。

原理流程

  1. 替身服务抛出各类业务异常。
  2. 发起请求触发处理链。
  3. 断言状态码与错误结构。
  4. 验证兜底异常不泄露堆栈。

代码或图示

// 替身抛 NotFoundException -> 断言 404 与错误码
assertEquals(HttpStatusCode.NotFound, res.status)

常见误区

  • 只测正常成功路径:异常映射未验证。
  • 断言响应含内部堆栈:生产安全问题。

追问

  • 待确认:异常类型到状态码的映射测试入口,与 StatusPages 实现核对。
  • 异步子协程异常怎么测?答:触发后等待收敛,断言最终响应或日志。

06.8.1.3-068 WebSocket 与 SSE 如何测试?

一句话结论

WS 测试在测试环境建立模拟会话,收发帧断言消息分派与清理;SSE 测试读取事件流断言事件格式与标识;断开重连、心跳超时等路径用可控时钟/模拟连接验证,不依赖真实端口。

概念解释

长连接测试关注:握手认证、消息编解码、收发循环、结束清理、断线重连。测试替身模拟对端帧与断开事件。流类响应按读取循环断言逐事件输出,而非整体 body 比对。

原理流程

  1. 测试装配应用与 WS/SSE 路由。
  2. 建立测试会话或流连接。
  3. 发送入站事件断言出站响应。
  4. 模拟断开断言清理与重连逻辑。

代码或图示

WS:测试会话 -> 入站帧 -> 断言出站帧 -> 关闭清理
SSE:读取事件流 -> 断言 event/data/id 字段

常见误区

  • 长连接用普通请求断言整体响应:流未读取完。
  • 不验证会话清理:在线集合泄漏未发现。

追问

  • 待确认:Ktor 3 WS/SSE 测试辅助 API,以官方测试文档核对。
  • 心跳超时怎么测?答:用可控时间源模拟超时,避免真实等待拉长测试。

06.8.1.3-069 测试配置与环境如何隔离?

一句话结论

测试使用独立配置:内存替身、固定端口/无端口、测试日志级别;不连接生产与共享测试环境数据库;配置通过装配入口注入,不依赖本机环境变量残留;测试数据独立准备与清理。

概念解释

环境隔离保证用例可重复执行:无外部状态依赖、无本机路径与账号配置。测试配置与生产配置分离,替身覆盖外部依赖。并行测试之间数据不互相干扰。

原理流程

  1. 测试装配加载测试配置。
  2. 外部依赖替换为内存替身。
  3. 用例准备独立数据。
  4. 结束清理测试状态。

代码或图示

隔离项:配置源 / 外部服务 / 数据库 / 缓存 / 日志 / 测试数据

常见误区

  • 测试读本机开发配置:换机器用例失败。
  • 共享测试库数据残留:用例顺序依赖。

追问

  • 待确认:项目测试配置文件位置,按工程结构核对。
  • 集成测试连真实服务怎么办?答:独立测试环境,数据可重置,与单元测试分层。

06.8.1.3-070 单元测试与应用测试如何分层?

一句话结论

单元测试覆盖纯逻辑(校验、映射、消息分派),不启动应用;应用测试通过 testApplication 覆盖路由、插件与管道行为;外部契约用集成测试在真实依赖上验证;三层职责分明、执行速度分层。

概念解释

分层依据:依赖边界。纯函数与算法单测快速运行;管道装配与请求链路用应用测试;网络、数据库、消息等真实契约用集成测试。测试金字塔:大量单测、适量应用测试、少量集成测试。

原理流程

  1. 纯逻辑抽离为可单测函数。
  2. 应用测试装配模块验证请求链路。
  3. 少量集成测试验证外部契约。
  4. 按层选择运行时机(提交前/流水线)。

代码或图示

单元:纯逻辑/映射/校验
应用:路由/管道/插件/认证
集成:真实下游/网络/存储

常见误区

  • 全部走应用测试:启动慢且断言绕弯。
  • 业务逻辑全在 Handler:无法单测。

追问

  • 待确认:项目测试分层约定,按工程文档核对。
  • Handler 逻辑怎么便于单测?答:抽到独立服务函数,Handler 只做入参出参编排。

06.8.1.3-071 测试数据清理策略如何设计?

一句话结论

每个用例准备独立数据并在用例结束后清理:内存替身自动重置,数据库用事务回滚或按用例标识删除;不依赖用例执行顺序;并行测试之间数据隔离,公共基线数据在前置一次性准备。

概念解释

数据清理保证可重复执行:残留数据会让用例顺序依赖并产生偶发失败。清理方式按存储选择:内存对象重建、数据库回滚/删除、缓存按命名空间隔离。敏感测试数据不使用真实生产样本。

原理流程

  1. 用例前置准备独立数据集。
  2. 执行断言。
  3. 后置清理或回滚。
  4. 下一个用例从干净状态开始。

代码或图示

清理层:内存替身重建 / DB 回滚或按标识删除 / 缓存命名空间清空

常见误区

  • 用例间靠前一个造的数据:顺序调换即失败。
  • 清理只删成功路径数据:异常路径残留。

追问

  • 待确认:项目测试数据库与清理约定,按工程文档核对。
  • 基线数据放哪里?答:测试前置一次性初始化,不随用例反复增删。

06.8.1.3-072 测试用例如何纳入持续集成执行?

一句话结论

流水线按层执行:提交前跑快速单元与应用测试,流水线跑集成测试;测试报告与覆盖率归档;环境依赖由流水线提供替身或测试环境;失败阻断发布,不跳过已知失败用例。

概念解释

CI 中测试需要确定性:无本机依赖、固定时间与随机值、服务可启停。分层执行控制反馈速度。失败用例修复或标记待确认,不长期注释跳过。测试环境与生产配置分离。

原理流程

  1. 提交触发快速测试层。
  2. 流水线执行应用与集成测试。
  3. 归档报告与覆盖率。
  4. 失败阻断构建,进入修复流程。

代码或图示

提交:单测 + 应用测试
流水线:集成测试 + 报告归档
发布门禁:测试通过 + 无遗留跳过用例

常见误区

  • 测试依赖本地服务/端口:CI 环境起不来。
  • 大量用例被注释跳过:质量门禁失效。

追问

  • 待确认:项目 CI 脚本与测试任务定义,按工程流水线配置核对。
  • 慢测试怎么处理?答:拆分到夜间/集成阶段,先优化测试速度再分层。

06.8.1.3-073 生产引擎选型要考量哪些因素?

一句话结论

按并发模型、阻塞比例、依赖体积、长连接支持、团队排障经验与压测结果选引擎;业务代码保持引擎无关;生产前在目标报文与并发下做基准测试,不凭印象定选型。

概念解释

引擎差异在连接管理、线程模型与协议特性(WS、HTTP/2 支持依实现)。考量维度:吞吐延迟基准、资源占用、成熟度与资料、依赖打包大小。选定后保留切换能力,业务不直引引擎类。

原理流程

  1. 梳理请求形态:短请求/长连接/阻塞比例。
  2. 列出候选引擎能力清单。
  3. 目标负载压测对比。
  4. 结合依赖与经验定稿。

代码或图示

选型维度:并发模型 / 长连接 / 性能基准 / 依赖体积 / 排障资料 / 团队经验

常见误区

  • 只看框架文档推荐:未结合自身负载。
  • 业务代码绑定引擎 API:后续无法切换。

追问

  • 待确认:Ktor 3 各引擎生产成熟度与 HTTP/2 支持,以官方文档核对。
  • 引擎能运行时切换吗?答:装配层换工厂即可,前提是代码未依赖引擎专属行为。

06.8.1.3-074 构建 FatJar 与运行方式如何组织?

一句话结论

服务构建为可执行 Jar(FatJar 包含依赖),由 JVM 直接运行;入口 main 启动引擎;构建产物与源码分离,运行命令固定;版本号、构建信息打入清单便于排障。

概念解释

部署产物是自包含 Jar,目标机器只装 JRE/JDK。启动命令指定 Jar、端口与配置环境变量。分层构建:编译、测试、打包流水线生成可部署制品。不依赖开发机目录结构。

原理流程

  1. 构建打包含依赖的可执行 Jar。
  2. 制品存入仓库或镜像层。
  3. 运行命令启动 main。
  4. 配置由环境变量/外部配置注入。

代码或图示

构建:编译 -> 测试 -> 打包 FatJar
运行:java -jar app.jar --port=8080

常见误区

  • 部署时散拷贝 class 文件:依赖缺失。
  • 启动依赖工作目录相对路径:换目录找不到配置。

追问

  • 待确认:项目打包脚本与 Jar 命名,按工程构建配置核对。
  • JDK 版本基线?答:与项目运行时基线一致,镜像内固定版本。

06.8.1.3-075 Docker 镜像如何打包?

一句话结论

镜像以运行时基础镜像为底,复制可执行 Jar,指定入口命令与暴露端口;分层构建利用缓存,镜像内不存放源码与密钥;非 root 用户运行,镜像版本标签与构建产物对应。

概念解释

容器化打包把 JRE 与应用 Jar 固化进镜像。多阶段构建先编译打包再拷贝运行产物,减小镜像体积。配置与密钥通过环境变量/挂载注入,不写进镜像层。镜像可重复构建,标签可追溯版本。

原理流程

  1. 构建阶段编译测试打包。
  2. 运行阶段基础镜像拷贝 Jar。
  3. 设置入口、端口与非 root 用户。
  4. 推送镜像仓库并打版本标签。

代码或图示

# 示意:多阶段结构;具体基础镜像版本按项目基线
FROM eclipse-temurin:21-jre AS runtime
WORKDIR /app
COPY app.jar /app/app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app/app.jar"]

常见误区

  • 镜像内塞源码与构建工具:体积大且泄露信息。
  • 密钥写进镜像层:可从镜像历史取出。

追问

  • 待确认:项目基础镜像与 JDK 版本约定,按部署文档核对。
  • 镜像层缓存怎么利用?答:先拷依赖清单再拷 Jar,变化层最小化。

06.8.1.3-076 容器内端口绑定与非 root 运行如何配置?

一句话结论

容器内服务绑定 0.0.0.0 使端口可达,端口映射由编排层声明;容器用非 root 用户运行,避免进程拥有容器内过高权限;只读文件系统与必要写目录挂载按需要配置。

概念解释

绑定回环地址会导致容器外访问不通。非 root 运行降低容器逃逸影响面;写目录(临时文件、日志)通过挂载或临时卷提供。端口号与编排映射关系在部署清单中明确。

原理流程

  1. 应用监听 0.0.0.0 指定端口。
  2. 编排层声明容器端口与映射。
  3. 镜像创建非 root 用户并切换。
  4. 可写目录挂载到用户可写位置。

代码或图示

容器内:bind 0.0.0.0:8080
编排:containerPort 8080,非 root 用户运行

常见误区

  • 绑 127.0.0.1:容器网络外不可达。
  • 以 root 跑应用:容器被攻破后权限过高。

追问

  • 待确认:项目编排端口与用户配置,按部署清单核对。
  • 特权端口(<1024)能在容器用吗?答:非 root 下需端口映射能力,建议用高位端口。

06.8.1.3-077 健康检查与就绪探针如何设计?

一句话结论

存活探针检查进程是否健康(是否需要重启),就绪探针检查是否能接流量(依赖可达、装配完成);两者分开:就绪失败摘流量,存活失败重启;探针接口不认证但限制来源,响应轻量快速。

概念解释

就绪关注「能否服务」:依赖连接、配置加载完成;存活关注「进程是否卡死」。探针端点不应触发重业务逻辑,避免误摘或误重启。慢依赖未就绪时返回未就绪,让编排层摘除实例。

原理流程

  1. 实现存活检查:进程与基本线程状态。
  2. 实现就绪检查:依赖可达、初始化完成。
  3. 编排层配置探针路径与阈值。
  4. 未就绪摘流量,不健康触发重启。

代码或图示

routing {
    get("/health/live") { call.respondText("ok") }
    get("/health/ready") { /* 依赖检查 */ }
}

常见误区

  • 探针查重依赖:依赖抖动导致频繁重启。
  • 存活与就绪混用:该摘流量的实例被直接重启。

追问

  • 待确认:项目探针路径与阈值配置,按编排清单核对。
  • 启动慢应用怎么处理?答:就绪探针加启动宽限,未完成前不接流量。

06.8.1.3-078 优雅停机在部署中如何配合?

一句话结论

发布/缩容时先摘就绪探针,等待在途请求完成(宽限时限),再停止进程;容器收到停机信号后执行应用停机钩子释放连接池与后台任务;超时后强制终止,保证滚动发布不丢在途请求。

概念解释

优雅停机与编排生命周期配合:信号 -> 停止接收新流量 -> 在途处理 -> 资源释放 -> 退出。宽限时间按接口最长响应设定。长连接(WS)在停机时主动通知客户端重连,而非硬断。

原理流程

  1. 编排摘除实例流量。
  2. 应用收到停机信号。
  3. 等待在途请求至宽限上限。
  4. 释放资源退出;超时强制终止。

代码或图示

摘流量 -> 在途请求处理 -> 宽限等待 -> 释放资源 -> 退出

常见误区

  • 收到信号立即杀进程:在途请求截断。
  • 停机钩子不释放客户端/池:实例残留连接。

追问

  • 待确认:Ktor 3 停机信号与宽限配置,以引擎文档核对。
  • WS 连接停机怎么处理?答:发关闭帧通知客户端重连新实例,宽限内完成迁移。

06.8.1.3-079 环境变量与配置如何注入容器?

一句话结论

配置通过环境变量、挂载配置文件或配置中心注入容器;镜像不含环境差异配置;敏感值走密钥挂载/注入,不写镜像层与仓库;应用启动时读取配置并校验必填项。

概念解释

十二要素式配置与代码分离:同一镜像部署不同环境。配置优先级在启动层合并,缺失必填项启动失败。密钥轮换通过更新注入,不重新构建镜像。配置变更生效方式按设计(重启或热刷新)。

原理流程

  1. 镜像只含代码与默认值。
  2. 编排注入环境变量/配置挂载。
  3. 启动读取合并配置。
  4. 校验必填后进入服务。

代码或图示

注入方式:环境变量 / 配置挂载 / 配置中心
禁止:密钥写入镜像层、仓库配置文件

常见误区

  • 多环境配置打进镜像:镜像不可复用。
  • 配置非法仍启动:请求期才暴露问题。

追问

  • 待确认:项目配置源与优先级约定,按部署文档核对。
  • 配置热更新怎么做?答:显式设计刷新通道,不假设配置自动重载。

06.8.1.3-080 日志输出如何与容器化收集配合?

一句话结论

应用日志输出到标准输出/错误流,由容器日志收集代理采集;不在容器内写持久化日志文件;结构化日志带 trace 标识,级别按环境配置;敏感字段脱敏,日志轮转由收集侧负责。

概念解释

容器文件系统临时且随实例销毁,日志应走标准流由外部采集。结构化输出便于日志平台检索。级别:生产 INFO 或以上,排查时临时调整。日志与审计分开,脱敏规则统一。

原理流程

  1. 日志框架配置输出 stdout/stderr。
  2. 结构化字段与 trace 标识。
  3. 容器代理采集到日志平台。
  4. 轮转与保留策略在收集侧管理。

代码或图示

应用 -> stdout/stderr -> 节点/代理采集 -> 日志平台

常见误区

  • 日志写容器本地文件:实例销毁后丢失。
  • 标准输出打印敏感凭据:随日志泄露。

追问

  • 待确认:项目日志框架与输出格式约定,按工程配置核对。
  • 异常堆栈怎么采集?答:结构化事件携带堆栈字段,由平台检索。

06.8.1.3-081 进程管理与后台运行如何处理?

一句话结论

部署形态由编排/进程管理器负责前台运行与重启策略;应用本身不 fork 后台守护进程;崩溃后由管理器按策略重启,退出码区分正常退出与故障;单实例内后台任务绑定应用生命周期。

概念解释

容器场景应用以前台进程运行,管理器监控退出状态。裸机部署可用 systemd 等进程管理器。应用内后台协程不是系统守护进程,随应用停止。重启策略配合健康检查,避免崩溃循环。

原理流程

  1. 应用前台启动主进程。
  2. 进程管理器监控存活与退出码。
  3. 崩溃按策略重启。
  4. 应用内后台任务随主进程生命周期管理。

代码或图示

容器:前台 Java 进程 -> 编排重启策略
裸机:进程管理器托管服务进程

常见误区

  • 应用内自行 daemon 化:进程管理器失去监控。
  • 崩溃循环无退避:持续重启放大故障。

追问

  • 待确认:项目部署进程管理方式,按部署文档核对。
  • 退出码约定?答:正常退出与异常退出区分,供管理器判定重启策略。

06.8.1.3-082 Kubernetes 部署有哪些注意事项?

一句话结论

部署配置含副本数、资源请求与上限、探针、滚动发布策略与优雅停机;配置与密钥分离注入;无状态服务水平扩缩;环境变量与配置映射按对象注入,避免实例本地状态。

概念解释

K8s 编排管理副本、网络与生命周期。资源配额防止节点过载;探针决定摘流与重启;滚动发布控制新旧版本共存。服务发现与负载均衡由平台提供,应用不写死实例地址。

原理流程

  1. 配置副本与资源配额。
  2. 配置存活/就绪探针与停机宽限。
  3. 滚动发布策略与最大不可用/超量。
  4. 配置与密钥通过环境/卷注入。

代码或图示

Deployment:replicas / resources / probes / strategy
ConfigMap / Secret:配置与密钥注入

常见误区

  • 不设资源上限:实例挤占节点资源。
  • 忽略停机宽限:滚动发布截断在途请求。

追问

  • 待确认:项目 K8s 清单模板,按部署仓库核对。
  • 有状态长连接服务怎么扩缩?答:连接迁移与重连策略配合缩容,WS 实例保存连接状态需特殊设计。

06.8.1.3-083 静态资源在部署中如何处理?

一句话结论

静态资源可打入镜像随服务分发,或由 CDN/对象存储托管;版本化文件名配合长缓存;服务端挂载目录只读;动态接口与静态资源发布流程分离,避免每次发版重传全部资源。

概念解释

静态资源部署选择:随 Jar/镜像分发适合小规模;CDN 托管适合大流量前端。资源路径带内容哈希,发版更新索引引用。容器内资源目录只读,上传类可写目录单独挂载。

原理流程

  1. 构建产物含版本化静态资源。
  2. 镜像分发或上传 CDN/存储。
  3. 服务挂载只读资源目录。
  4. 索引页面引用新版本哈希资源。

代码或图示

方案 A:资源打入镜像随服务发布
方案 B:资源上 CDN/对象存储,服务只发索引

常见误区

  • 未版本化资源长缓存:发版后客户端旧文件。
  • 静态资源目录可写:容器逃逸与篡改风险。

追问

  • 待确认:项目前端资源与服务端资源分发方式,按工程结构核对。
  • 缓存失效怎么处理?答:版本化文件名 + 索引不缓存。

06.8.1.3-084 多实例部署与无状态约束是什么?

一句话结论

多实例下应用不保存请求级与会话级本地状态;共享状态外置到数据库/缓存/对象存储;实例可随时重启与扩缩;本地缓存仅作可重建的只读优化,会话与计数走共享存储。

概念解释

水平扩缩前提:任意实例可处理任意请求。本地内存会话、限流计数、上传文件在多实例下不一致。会话粘滞只是过渡方案,不消除状态外置需求。无状态设计让发布与扩容简单可控。

原理流程

  1. 识别本地状态清单。
  2. 会话/计数/文件外置共享存储。
  3. 本地缓存可失效重建。
  4. 实例无状态化后副本自由调度。

代码或图示

实例无状态 + 共享 DB/Redis/对象存储
本地:仅只读可重建缓存

常见误区

  • 用会话粘滞代替状态外置:实例重启仍丢状态。
  • 本地限流计数:多实例配额成倍放大。

追问

  • 待确认:项目共享存储组件清单,按架构文档核对。
  • 长连接状态怎么多实例共享?答:连接留在节点,跨节点路由经中间件,见 WS 推送题目。

06.8.1.3-085 启动失败与端口占用如何排查?

一句话结论

启动失败先看异常堆栈:端口占用、配置缺失、依赖连接失败、类加载冲突;端口占用查监听进程与残留实例;容器内区分绑定地址与端口映射;配置类错误在启动日志定位缺失键。

概念解释

启动阶段失败类型:网络绑定、配置校验、外部依赖连接、构建/类冲突。排查顺序:读堆栈 -> 定位类别 -> 核对环境与配置 -> 检查残留进程。不要反复重启不查根因。

原理流程

  1. 读取启动异常与错误信息。
  2. 区分绑定/配置/依赖/类加载问题。
  3. 检查端口监听与残留实例。
  4. 核对配置源与依赖连通性。

代码或图示

排查链:堆栈 -> 端口占用 -> 配置缺失 -> 依赖连通 -> 类/版本冲突

常见误区

  • 只看最终退出码:根因在早期日志。
  • 容器端口与宿主机映射混淆:进程内正确但外部不通。

追问

  • 待确认:各引擎绑定失败异常类型,以引擎实现核对。
  • 依赖连不上怎么区分?答:启动日志的连接异常与超时记录,核对网络与凭据配置。

06.8.1.3-086 资源配额:内存、线程与连接数如何估算?

一句话结论

内存按堆外+堆内占用与报文大小估算并设上限;线程数按阻塞比例与并发模型调优;连接数(下游连接池、入站连接)按下游容量与实例数分配;配额以压测拐点为依据,不照搬公式。

概念解释

资源配额互相影响:内存不足触发 GC 或 OOM,线程过多增加切换,连接数受下游限制。估算输入:并发量、单请求内存、阻塞比例、下游连接上限。压测验证拐点后设定请求与限制。

原理流程

  1. 压测测得单请求内存与线程占用。
  2. 按目标并发估算堆与线程需求。
  3. 下游连接池按下游容量分摊到实例。
  4. 设资源上限与过载保护。

代码或图示

内存:堆内对象 + 报文缓冲 + 堆外
线程:并发模型 × 阻塞比例
连接:下游总容量 / 实例数

常见误区

  • 线程数设成等于并发连接数:协程模型下不必要。
  • 不设内存上限:单个大报文拖垮容器。

追问

  • 待确认:项目资源基线与压测数据,按部署记录核对。
  • 过载保护怎么做?答:队列上限 + 快速拒绝 + 降级,避免资源耗尽雪崩。

06.8.1.3-087 部署版本回滚与健康基线如何管理?

一句话结论

发布前建立健康基线(指标、探针、错误率),新版本灰度观察指标偏离后再全量;回滚到上一稳定制品,配置兼容回滚;数据库变更向后兼容,避免回滚被旧版本卡住。

概念解释

回滚能力依赖制品可追溯与配置兼容。健康基线对照:延迟、错误率、探针状态、下游调用成功率。灰度阶段异常自动或手动回退。回滚演练纳入发布流程,不等到故障时尝试。

原理流程

  1. 记录上一稳定制品与配置。
  2. 灰度发布对比健康基线。
  3. 异常触发回滚到稳定版本。
  4. 数据库变更保持向后兼容。

代码或图示

基线指标:延迟分位 / 错误率 / 探针 / 下游成功率
回滚:稳定制品 + 兼容配置 + 向后兼容 DB 变更

常见误区

  • 数据库变更不兼容回滚:旧版本无法启动。
  • 不建基线:新版本是否退化无法判断。

追问

  • 待确认:项目发布与回滚流程,按部署文档核对。
  • 配置变更能单独回滚吗?答:按配置版本管理,与制品回滚分别处理。

06.8.1.3-088 部署脚本与基线配置有哪些待核对点?

一句话结论

核对:打包脚本入口、运行时版本、端口与配置注入方式、探针路径、停机宽限、资源配额与镜像基础版本;未核实的命令与参数标「待确认」,以项目构建部署文件为准,不编造脚本内容。

概念解释

部署基线包括构建命令、运行命令、环境变量清单、健康检查与资源限制。核对路径:项目构建脚本、编排清单、部署文档。脚本应自定位目录、不写死本机路径,可在任意环境重复执行。

原理流程

  1. 收集项目构建与部署配置。
  2. 逐项核对版本、端口、探针、资源。
  3. 标注与官方文档不一致的待确认点。
  4. 变更后在测试环境验证部署流程。

代码或图示

核对清单:构建命令 / 运行时版本 / 配置注入 / 探针 / 停机宽限 / 资源配额 / 基础镜像

常见误区

  • 凭通用模板写项目专属部署参数:与实际清单不符。
  • 脚本写死本机目录路径:跨环境不可用。

追问

  • 待确认:本项目实际构建脚本与部署清单,以仓库内脚本/编排文件为准。
  • 跨平台脚本约定?答:按项目 .gitattributes 与脚本规范维护换行与入口。

06.8.1.3-089 场景:长连接服务如何做容量规划?

一句话结论

按单连接内存占用、消息速率与心跳开销估算可承载连接数;连接数配额分实例与全局;消息推送带宽与队列深度纳入规划;连接限流与降级预案配套,扩缩容基于连接数与消息积压指标。

概念解释

长连接资源模型不同于短请求:连接常驻占用内存与文件描述符,消息突发占用队列与带宽。规划输入:单连接缓冲、在线峰值、消息频率、心跳流量。单实例连接上限在引擎与系统层面都要核对。

原理流程

  1. 压测单连接内存与 FD 占用。
  2. 估算峰值连接数与实例数。
  3. 评估消息突发队列与带宽。
  4. 配置连接限流与扩容指标。

代码或图示

容量:连接数 × 单连接内存/FD + 消息速率 × 队列/带宽

常见误区

  • 按短请求线程模型估算长连接:资源占用误判。
  • 不限制连接数:恶意连接打满实例资源。

追问

  • 待确认:引擎与系统文件描述符上限配置,按部署环境核对。
  • 连接迁移怎么做?答:缩容时通知重连,新实例承接,状态经共享存储恢复。

06.8.1.3-090 场景:第三方调用超时如何不拖垮主流程?

一句话结论

下游调用设独立超时与隔离池,失败快速降级;并发度受控,重试有限;主流程不被慢下游阻塞,超时返回兜底结果或部分数据;下游异常指标告警,熔断防止持续冲击。

概念解释

慢下游拖垮主流程的路径:线程/连接被等待占满 -> 新请求排队 -> 整体雪崩。隔离手段:超时、舱壁池、熔断、降级。关键依赖与次要依赖分别配置策略,次要失败不阻断主功能。

原理流程

  1. 识别下游依赖与重要级别。
  2. 配置超时、隔离池与并发上限。
  3. 超时/熔断走降级响应。
  4. 监控下游延迟与失败率告警。

代码或图示

withTimeoutOrNull(1_500) { remote.fetch() } ?: fallback()

常见误区

  • 所有下游共用无界线程池:一个慢依赖拖累全部。
  • 重试叠加超时:下游故障时压力放大。

追问

  • 待确认:项目熔断/舱壁组件选型,按实际依赖核对。
  • 降级数据从哪来?答:缓存、默认值或部分聚合,按业务可接受度设计。

06.8.1.3-091 场景:接口测试应覆盖哪些关键路径?

一句话结论

覆盖:正常成功、参数校验失败、未认证/无权限、下游失败降级、并发与边界值;核心业务链路端到端走通;异常状态码与错误结构断言;测试数据与替身隔离,关键路径纳入 CI 门禁。

概念解释

测试路径按风险排序:主流程先覆盖,错误分支与安全路径补齐。边界值(分页上下限、空集合、大报文)与并发场景单独验证。每个对外接口至少有成功与一类失败用例。

原理流程

  1. 列出接口清单与依赖。
  2. 标注核心链路与安全路径。
  3. 编写成功/失败/边界用例。
  4. 纳入 CI 并定期补全覆盖缺口。

代码或图示

覆盖矩阵:成功 / 校验失败 / 认证授权 / 下游异常 / 边界值 / 并发

常见误区

  • 只覆盖 happy path:错误与安全分支裸奔。
  • 测试断言只看状态码:响应内容未验证。

追问

  • 待确认:项目测试覆盖度要求,按工程质量约定核对。
  • 遗留未覆盖接口怎么跟踪?答:列入待整理清单,随业务迭代补齐。

06.8.1.3-092 场景:容器发布如何做到不停机?

一句话结论

滚动发布:新实例就绪后摘旧实例流量,旧实例等待在途请求完成再停机;就绪探针控制接入时机,优雅停机宽限覆盖最长请求;版本与配置向后兼容,新旧版本短暂共存期间接口契约一致。

概念解释

不停机依赖:就绪探针、优雅停机、负载均衡摘除与兼容契约。灰度先起新版本接少量流量,再逐步替换旧版本。数据库与配置变更兼容旧版本运行。WS 等长连接在旧实例下线时引导重连。

原理流程

  1. 启动新实例,就绪通过后接入。
  2. 流量逐步切到新版本。
  3. 旧实例摘流量并等待在途完成。
  4. 旧实例释放资源退出。

代码或图示

新实例就绪 -> 流量切换 -> 旧实例摘流 -> 在途完成 -> 旧实例退出

常见误区

  • 旧实例收到信号立即终止:在途请求截断。
  • 接口契约不兼容:共存版本互相调用失败。

追问

  • 待确认:项目滚动发布策略与 maxUnavailable 配置,按编排清单核对。
  • 长连接发布怎么平滑?答:通知客户端重连,旧实例宽限内逐步断开。

06.8.1.3-093 客户端连接池满了如何排查?

一句话结论

池满表现为请求等待连接或超时:先看池占用与等待队列,确认响应是否消费归还、并发是否超配、下游连接是否被对端关闭;区分泄漏(未消费)与容量不足(并发过高)。

概念解释

连接池耗尽两类原因:连接未归还(泄漏)或需求超过池容量。排查指标:空闲连接、等待线程、新建连接速率、下游关闭现象。代码走查响应消费与异常分支,容量按压测调整。

原理流程

  1. 采集池占用、等待队列与连接生命周期。
  2. 检查响应体是否全部消费。
  3. 核对并发度与池上限、下游容量。
  4. 修复泄漏或调整池/并发配额。

代码或图示

排查:池空闲数 / 等待队列 / 响应消费路径 / 下游断连 / 并发上限

常见误区

  • 直接调大池上限:泄漏被掩盖,下游被压垮。
  • 忽略异常分支未读 body:连接持续滞留。

追问

  • 待确认:所用引擎连接池指标暴露方式,以引擎文档核对。
  • 池满时新请求怎么处理?答:快速失败降级,不无限排队等待。

06.8.1.3-094 WebSocket 连接数过高如何限流?

一句话结论

按主体(用户/租户/IP)与全局上限限制连接数:握手阶段计数,超限拒绝升级;连接结束释放计数;配合心跳清理死连接;多实例全局限额经共享存储统计,防单实例绕过。

概念解释

连接限流保护内存与文件描述符。维度:单用户多设备上限、单 IP 上限、全局连接上限。计数在握手成功时增加,会话结束减少;崩溃连接由心跳/超时清理后释放额度。

原理流程

  1. 握手前检查主体连接计数。
  2. 超阈值拒绝握手。
  3. 成功建立计入额度。
  4. 结束/超时后释放计数。

代码或图示

限流维度:全局 / 每用户 / 每 IP
计数:握手 +1,会话结束 -1,死连接超时回收

常见误区

  • 只限制消息频率不限制连接数:连接本身占资源。
  • 崩溃连接计数不释放:额度被幽灵连接耗尽。

追问

  • 待确认:项目连接限额策略,按容量规划核对。
  • 多实例计数怎么一致?答:共享存储统计,允许短暂误差按业务容忍度设定。

06.8.1.3-095 响应体过大导致内存问题如何处理?

一句话结论

大响应改为流式分块写出,不在内存聚合成全量对象;限制单响应大小;大列表分页或游标加载;监控响应大小分布与堆内存峰值,区分报文过大与对象模型冗余。

概念解释

内存爆点:全量集合进堆、报文缓冲未释放、序列化大对象。处理方向:分批/流式、分页查询、DTO 精简。上传与下载分别控制大小。压测用最大报文验证内存峰值。

原理流程

  1. 定位大响应来源:列表规模/字段冗余/文件下载。
  2. 改流式或分页加载。
  3. 限制单响应与单字段大小。
  4. 压测验证堆峰值与 GC 表现。

代码或图示

优化:分页/游标 -> 流式写出 -> DTO 精简 -> 大小上限

常见误区

  • 一次性查全表再序列化:堆峰值随数据量线性增长。
  • 响应 DTO 携带多余实体字段:序列化体积放大。

追问

  • 待确认:项目列表接口分页基线,按 API 约定核对。
  • 流式响应与缓存/压缩如何配合?答:按响应类型排除不兼容插件,见压缩题目。

06.8.1.3-096 部署后探针失败常见原因有哪些?

一句话结论

探针失败常见于:依赖未就绪、端口绑定地址错误、探针路径未注册、启动配置缺失、资源不足导致进程卡死;区分存活失败与就绪失败,按日志与事件定位,不要盲目重启反复触发。

概念解释

就绪失败多为依赖连接、初始化未完成;存活失败多为进程死锁、OOM、卡死。排查看应用启动日志、依赖连通性、探针路由与资源事件。探针自身实现过重也会误判。

原理流程

  1. 区分存活/就绪失败类型。
  2. 读应用日志定位启动阶段。
  3. 核对依赖连通与配置。
  4. 检查探针路由、绑定地址与资源事件。

代码或图示

就绪失败:依赖 / 初始化 / 配置
存活失败:死锁 / OOM / 进程卡死

常见误区

  • 探针查重依赖:依赖抖动误判未就绪。
  • 探针路径未注册:一直 404 被判定失败。

追问

  • 待确认:项目探针实现与编排阈值,按部署清单核对。
  • 启动慢被反复重启怎么办?答:配置启动宽限,就绪探针延迟开始检查。

06.8.1.3-097 服务端与客户端版本兼容注意什么?

一句话结论

接口契约向后兼容:字段新增可选、旧字段不随意改类型/删除;序列化配置两端一致;版本通过路径、头或契约标识区分;废弃字段过渡期保留,客户端按容错策略解析未知字段。

概念解释

兼容问题出现在滚动发布期间:新旧客户端与服务端短暂共存。字段约定:新增可选、删除先废弃、类型不变。枚举与日期格式两端对齐。破坏性变更走独立版本接口,不原地改契约。

原理流程

  1. 契约变更评估向后兼容。
  2. 新增字段可选,解析忽略未知键。
  3. 破坏性变更新版本号。
  4. 过渡期观察旧版本调用量后下线。

代码或图示

兼容策略:可选新增 / 废弃保留 / 类型不变 / 破坏性变更独立版本

常见误区

  • 服务端收紧未知字段:旧客户端新字段被拒。
  • 枚举新增值旧客户端不识别:分支遗漏报错。

追问

  • 待确认:项目接口版本约定,按 API 文档核对。
  • WS 协议版本怎么兼容?答:握手子协议标识版本,消息信封带版本字段。

06.8.1.3-098 压测指标与容量拐点怎么看?

一句话结论

压测看吞吐、延迟分位、错误率、资源利用率与下游依赖;拐点是吞吐不再上升或延迟骤升、资源打满的位置;容量按拐点留余量设定,过载保护在拐点之前触发。

概念解释

单看平均值会掩盖长尾。分位延迟反映用户体验,资源利用率定位瓶颈(CPU/内存/连接/下游)。逐级加压找到拐点,区分自身瓶颈与下游瓶颈。容量目标负载低于拐点并留余量。

原理流程

  1. 按典型报文逐级加压。
  2. 采集吞吐、P95/P99、错误率、资源指标。
  3. 定位瓶颈资源与拐点。
  4. 设定生产容量与过载阈值。

代码或图示

拐点特征:吞吐停滞 / 延迟骤升 / CPU 或连接池打满 / 错误率上升

常见误区

  • 以最高吞吐定容量:长尾延迟已不可接受。
  • 压测不隔离下游:瓶颈定位错误。

追问

  • 待确认:项目压测环境与基线数据,按性能记录核对。
  • 容量余量留多少?答:按业务峰值增长与突发系数设定,不贴拐点运行。

06.8.1.3-099 常见生产事故复盘应覆盖哪些清单?

一句话结论

复盘覆盖:现象与影响范围、触发条件、时间线、根因(代码/配置/容量/依赖)、检测与告警是否及时、恢复动作与遗留改进项;形成可追踪的改进任务,不只归因为「流量大」。

概念解释

事故清单:监控缺失、配置漏配、容量不足、依赖故障、发布缺陷、安全问题。复盘区分直接原因与流程原因:测试覆盖、发布门禁、预案演练。改进项有负责人与期限,回归验证。

原理流程

  1. 还原时间线与影响面。
  2. 定位根因与触发条件。
  3. 评估检测、告警、恢复各环节缺口。
  4. 输出改进任务并跟踪闭环。

代码或图示

复盘清单:现象 / 时间线 / 根因 / 检测告警 / 恢复动作 / 改进项 / 回归验证

常见误区

  • 复盘只写操作总结:根因与改进未落地。
  • 同类问题重复发生:改进项未跟踪闭环。

追问

  • 待确认:项目事故记录模板,按团队流程核对。
  • 预案演练怎么做?答:定期演练故障切换、降级与回滚,验证预案可执行。

06.8.1.3-100 Ktor 客户端与服务端一体有哪些适用场景?

一句话结论

同一套协程模型、序列化配置与 DTO 在服务端与客户端复用,适合内部服务间调用、工具型应用、多端 SDK 与轻量网关;重企业生态集成或既有容器体系下,按团队与依赖成熟度评估。

概念解释

一体优势:跨端代码与契约复用、协程语义一致、插件思路同构。限制:客户端引擎与服务端引擎生态不完全对等,小众集成仍需自研。选型结合团队 Kotlin/协程经验与长期维护成本。

原理流程

  1. 识别可复用的 DTO、序列化与客户端配置。
  2. 评估服务间调用场景与生态依赖。
  3. 概念验证关键链路。
  4. 按维护成本定稿框架边界。

代码或图示

适合:内部服务调用 / 工具应用 / 多端 SDK / 轻量协程网关
评估:企业集成需求 / 团队经验 / 生态成熟度

常见误区

  • 为复用而硬上一体:两端需求差异被忽视。
  • 假设客户端服务端插件完全通用:集合与配置有差异。

追问

  • 待确认:Ktor 3 客户端/服务端组件成熟度,以官方文档与生态核对。
  • 与既有 HTTP 客户端并存可行吗?答:可按服务域选择,不必全量替换。

参考来源

待整理清单

  • [ ] 核对 Ktor 3 客户端引擎清单、连接池与超时配置项名称
  • [ ] 核对 WS 服务端/客户端注册 DSL、会话收发 API、帧类型与心跳配置
  • [ ] 核对 SSE 支持方式(原生插件或流式响应)与 Last-Event-ID 处理
  • [ ] 核对 testApplication、测试客户端与 MockEngine 的 API 签名
  • [ ] 核对项目打包脚本、运行时版本、探针路径与资源配额基线
  • [ ] 补充实际工程中的客户端隔离、WS 连接管理与部署编排示例