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。客户端实例可复用,内部维护连接池。
原理流程
- 构造 HttpClient 并选定引擎工厂。
- 安装客户端插件(序列化、日志、认证等)。
- 通过请求 DSL 发起调用。
- 响应经插件链解析为类型化结果。
代码或图示
val client = HttpClient(CIO) {
install(ContentNegotiation) { /* ... */ }
}
常见误区
- 把客户端当一次性工具每次新建:连接池无法复用。
- 忽略关闭实例:连接与线程资源泄漏。
追问
- 客户端与服务端插件 API 完全一致吗?答:机制同构,具体插件集合与配置项有差异,以客户端文档为准。
- 待确认:Ktor 3 客户端引擎清单,以官方文档核对。
06.8.1.3-002 客户端引擎有哪些,如何选型?
一句话结论
客户端引擎包括 CIO、Apache、Java 等实现(具体可用清单以版本为准);选型看异步模型、依赖体积、TLS 能力与既有运行时;协程原生场景优先协程导向引擎,阻塞兼容需求选对应实现。
概念解释
引擎决定 HTTP 客户端底层实现:连接管理、线程模型、异步回调方式。业务代码通过统一 HttpClient 接口与引擎解耦,可按测试与生产替换。引擎差异在超时、连接池与代理支持上体现。
原理流程
- 列出可用引擎与依赖约束。
- 评估异步模型与项目运行时。
- 验证 TLS、代理、连接池能力。
- 压测对比吞吐与延迟后选定。
代码或图示
HttpClient(CIO) { /* 协程导向 */ }
HttpClient(Apache) { /* 阻塞兼容实现,能力以引擎为准 */ }
常见误区
- 不核对引擎能力:某些高级配置只在特定引擎生效。
- 引擎切换后不回归:连接与超时行为可能变化。
追问
- 待确认:Ktor 3 客户端各引擎维护状态与推荐场景,以官方文档核对。
- 测试中能换引擎吗?答:可以,测试可用 MockEngine 或轻量引擎。
06.8.1.3-003 HttpClient 的构造与配置入口是什么?
一句话结论
HttpClient(引擎工厂) { 配置闭包 } 构造实例:闭包内配置引擎参数、安装插件、设置默认请求头与超时;配置在构造期确定,实例共享同一套默认策略。
概念解释
配置闭包覆盖引擎连接参数、插件安装、默认请求与响应处理。实例构造一次后复用;每次请求可局部覆盖默认头与参数。配置项按引擎与插件分别组织。
原理流程
- 传入引擎工厂。
- 闭包配置引擎与默认策略。
- 安装插件并配置。
- 实例就绪后发起请求。
代码或图示
val client = HttpClient(CIO) {
engine { /* 连接参数,按引擎 API */ }
install(Logging) { /* ... */ }
defaultRequest { header("X-Client", "ktor") }
}
常见误区
- 每次请求 new HttpClient:连接池与线程重建成本高。
- 在请求内改全局默认配置:影响其他调用方。
追问
- 待确认:defaultRequest 与引擎配置 API 名称,以客户端文档核对。
- 不同下游能否用不同实例?答:可以,按下游隔离连接池与策略。
06.8.1.3-004 客户端实例应该复用还是每次新建?
一句话结论
长生命周期服务内应复用客户端实例:内部连接池、线程与插件状态可复用;按下游或策略分组实例,不要每个请求新建;实例在应用停机时统一关闭。
概念解释
新建实例会重复建立连接池与线程资源,高并发下造成连接与线程耗尽。复用实例需线程安全,客户端设计为可并发共享。不同超时、认证或连接池要求的下游可拆成独立实例。
原理流程
- 应用装配期构造客户端实例。
- 业务协程并发共享实例发请求。
- 连接复用由内部池管理。
- 停机事件中关闭实例释放资源。
代码或图示
// 装配期构造,注入到服务层
val apiClient = HttpClient(CIO) { /* ... */ }
常见误区
- 请求内
HttpClient(CIO).use { }:每次重建池连接。 - 复用实例却在内部存可变请求状态:并发污染。
追问
- 实例关闭后还能发请求吗?答:不能,已关闭实例调用失败,需重新构造。
- 多下游共享一个实例的风险?答:连接池与超时互相影响,关键下游建议隔离。
06.8.1.3-005 请求构造:方法、URL、头与参数如何写?
一句话结论
请求 DSL 指定 HTTP 方法、URL、请求头、查询参数与 body;URL 拼接走 DSL 参数能力,避免手拼编码;公共头在客户端默认请求配置,单次请求可覆盖。
概念解释
请求构造分方法、地址、元数据与载荷。查询参数由 DSL 编码,路径段按参数拼接;头区分默认公共头与单次请求头。body 在需要时设置并指定内容类型。
原理流程
- 选择方法动词(get/post/put 等)。
- 构造 URL 与查询参数。
- 补充请求头与 body。
- 发送并接收响应。
代码或图示
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 结构可能不同,需要分别反序列化。响应体必须被消费或正确释放,否则连接无法归还池。
原理流程
- 发起请求得到 HttpResponse。
- 判定状态码分支。
- 按类型反序列化 body 或读字节/文本。
- 消费完成连接归还池。
代码或图示
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 字节 -> 请求体。序列化配置(未知键、命名策略、日期格式)与服务端对齐。错误场景可手动发送字符串或字节。
原理流程
- 客户端安装序列化插件并配置 Json。
- 请求 body 传入 DTO 对象。
- 插件序列化为字节并设 Content-Type。
- 响应反序列化走同一配置。
代码或图示
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 数据集,按部件提供文件名、类型与流。上传大小与超时按文件规模调整。
原理流程
- 判定表单类型。
- 键值表单直接填参数。
- multipart 添加字段部件与文件部件。
- 发送并消费响应。
代码或图示
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 等待。下游慢调用必须设限,否则占用协程与连接。超时值按接口重要性与下游能力设定。
原理流程
- 在客户端或单次请求配置超时项。
- 连接/等待/读写分别计时。
- 超时抛对应异常。
- 上层决定重试或降级。
代码或图示
install(HttpTimeout) {
requestTimeoutMillis = 2_000
connectTimeoutMillis = 1_000
socketTimeoutMillis = 2_000
}
常见误区
- 只设整体超时不控连接:连接建立阶段卡住。
- 超时无限放大:下游长尾拖垮自身线程与连接池。
追问
- 待确认:HttpTimeout 插件配置项名称与默认值,以官方文档核对。
- 重试与超时如何配合?答:有限重试 + 退避,总时长仍受上游超时约束。
06.8.1.3-010 连接池与 Keep-Alive 参数如何理解?
一句话结论
客户端内部维护连接复用池,Keep-Alive 决定连接存活复用;池大小、空闲连接存活与等待队列按下游并发量配置;池满时新建连接或排队,参数依引擎实现。
概念解释
连接复用减少握手开销;池参数影响并发与资源占用。不同引擎的池实现与可配置项不同,不要假设参数同名。连接泄漏(响应未消费)会导致池内连接不可复用。
原理流程
- 配置引擎连接池大小与存活时间。
- 请求优先取空闲连接。
- 池满按引擎策略新建或排队。
- 响应消费后连接归还池。
代码或图示
连接池:空闲复用 / 上限 / 空闲存活 / 等待策略(按引擎配置)
常见误区
- 池上限设过大:下游连接数被打满。
- 不消费响应体:连接无法归还,池逐渐耗尽。
追问
- 待确认:各客户端引擎连接池配置入口,以引擎文档核对。
- 连接复用失效看什么?答:连接关闭头、代理断开与响应未消费日志。
06.8.1.3-011 客户端插件体系与服务端一致吗?
一句话结论
机制同构:都是 install 装配、管道拦截、配置闭包;插件集合不同——客户端有超时、重试、Cookie、代理等方向插件,服务端有认证、路由、内容协商等方向插件;同名插件行为按客户端语义适配。
概念解释
理解服务端插件模型可迁移到客户端:安装期配置、请求/响应阶段拦截、属性传递。客户端插件作用于出站请求与入站响应,不涉及路由匹配。跨端共享的是序列化配置思路,不是插件实例。
原理流程
- 客户端构造时 install 插件。
- 插件注册请求/响应阶段拦截。
- 请求出站前与响应入站后触发插件逻辑。
- 插件共享客户端级配置与状态。
代码或图示
HttpClient(CIO) {
install(HttpTimeout) { /* 出站超时 */ }
install(Logging) { /* 请求/响应日志 */ }
}
常见误区
- 把服务端认证插件直接搬到客户端:职责方向不同。
- 客户端插件里保存请求级可变状态:并发调用污染。
追问
- 待确认:Ktor 3 客户端插件清单,以官方客户端文档核对。
- 插件顺序影响什么?答:请求修改与日志记录的包裹层次,同服务端管道逻辑。
06.8.1.3-012 Logging 插件如何记录请求与响应?
一句话结论
Logging 插件在请求/响应阶段记录方法、URL、头与 body;配置日志级别与 body 打印开关;生产环境脱敏敏感头与令牌,避免完整 body 写入日志;日志层级按环境区分。
概念解释
插件可记录请求行、头、报文体与响应状态。body 记录受大小与级别限制;敏感凭据、Cookie、令牌必须脱敏。生产默认降低 body 日志级别,排查问题时临时开启。
原理流程
- 安装 Logging 插件并配置级别。
- 请求出站前记录方法/URL/头。
- 响应入站后记录状态与(可选)body。
- 敏感字段在日志层脱敏。
代码或图示
install(Logging) {
level = LogLevel.INFO
// 敏感头在日志输出前过滤,按插件能力配置
}
常见误区
- 生产打印 Authorization 与完整 body:敏感信息入日志。
- 日志 body 不限制大小:大响应撑爆日志存储。
追问
- 待确认:Logging 插件级别枚举与脱敏配置方式,以官方文档核对。
- 日志走哪个日志门面?答:按项目日志接入,插件输出可桥接到应用日志。
06.8.1.3-013 客户端 ContentNegotiation 如何接入?
一句话结论
与服务端同构:安装客户端序列化插件,配置 Json/Jackson 转换器;请求对象自动序列化,响应按类型反序列化;配置与下游服务对齐,未知键策略按兼容需要设定。
概念解释
客户端协商插件负责出站 body 编码与入站 body 解码。转换器按媒体类型匹配;默认 Accept 头由插件协商决定。与服务端共用 DTO 与序列化配置可减少往返偏差。
原理流程
- 安装客户端 ContentNegotiation。
- 配置序列化器与 Json 策略。
- 请求 setBody 对象时编码。
- 响应按接收类型解码。
代码或图示
install(ContentNegotiation) {
json(Json { ignoreUnknownKeys = true })
}
常见误区
- 客户端忽略未知键策略与服务端不一致:新版本字段解析异常。
- 响应期望类型与实际媒体类型不符:解码失败。
追问
- 待确认:客户端 Jackson 转换器接入方式,以文档核对。
- 非 JSON 响应怎么读?答:直接取字符串/字节,不走对象转换器。
06.8.1.3-014 客户端 Auth 插件如何携带凭据?
一句话结论
认证插件或默认请求头为出站请求附加凭据:Bearer 令牌、Basic 用户名密码或自定义签名头;凭据从安全配置获取,不写进代码;不同下游按实例隔离凭据。
概念解释
客户端凭据携带是出站横切:插件在请求出站前附加认证头。Basic 编码、Bearer 格式化由插件/DSL 完成。令牌刷新后更新实例配置,注意不要在日志中输出凭据。
原理流程
- 装配期获取凭据来源。
- 认证插件/默认请求附加凭据头。
- 出站请求携带凭据。
- 凭据轮换时更新配置或实例。
代码或图示
defaultRequest {
header(HttpHeaders.Authorization, "Bearer $token")
}
常见误区
- 凭据硬编码在源码或配置仓库:泄露风险。
- 多下游共用实例携带同一凭据:越权调用。
追问
- 待确认:Ktor 客户端是否提供认证插件及 provider 配置,以官方文档核对。
- 令牌过期在客户端怎么处理?答:刷新后更新请求头,配合 401 刷新流程。
06.8.1.3-015 Cookies 插件如何管理 Cookie?
一句话结论
Cookie 插件维护出站 Cookie 与入站 Cookie 存储;可配置 Cookie 存储策略(内存/自定义);跨域调用注意 Domain、Path 与安全属性;不要在手动头里重复处理插件管理的 Cookie。
概念解释
插件按响应 Set-Cookie 更新存储,后续请求按规则回带。Cookie 存储生命周期与客户端实例一致;敏感 Cookie 随实例关闭清理。手动管理与插件存储混用会导致重复或冲突。
原理流程
- 安装 Cookies 插件并配置存储。
- 响应 Set-Cookie 写入存储。
- 出站请求按 Domain/Path 匹配回带。
- 实例关闭清理存储。
代码或图示
install(Cookies) {
// 存储配置按插件 API
}
常见误区
- 插件与手动 Cookie 头同时设置:Cookie 重复或冲突。
- 跨域 Domain 配置过宽:不必要回带 Cookie。
追问
- 待确认:Ktor 3 Cookies 插件存储接口与配置,以官方文档核对。
- 分布式调用需要保持会话吗?答:无状态 API 优先令牌,Cookie 会话按浏览器场景使用。
06.8.1.3-016 客户端 Compression 插件如何工作?
一句话结论
客户端在请求 Accept-Encoding 声明可解压编码,对压缩响应自动解压;是否启用压缩按下游与报文权衡;解压在客户端完成,业务读到原始 body。
概念解释
压缩协商是双向的:客户端声明支持编码,服务端选择编码压缩,客户端解压还原。插件处理 Content-Encoding 解码,业务不感知编码格式。文本报文压缩收益明显,二进制通常不压。
原理流程
- 安装 Compression 插件。
- 出站请求带 Accept-Encoding。
- 响应带 Content-Encoding 时插件解压。
- 业务读取原始 body。
代码或图示
install(Compression) { /* 支持编码按插件配置 */ }
常见误区
- 以为发送给下游的 body 被压缩:压缩主要针对响应方向,按插件能力确认。
- 不解压直接解析压缩字节:解码失败。
追问
- 待确认:客户端 Compression 支持的编码与配置项,以文档核对。
- 大响应解压占内存吗?答:占用解压缓冲,流式响应需关注内存。
06.8.1.3-017 重试插件如何配置?
一句话结论
重试插件按条件(异常、可重试状态码)在有限次数内退避重试;只对幂等或安全可重试的调用重试,非幂等写操作谨慎;退避用指数间隔加抖动,总时长受超时约束。
概念解释
重试用于应对瞬时网络抖动与短暂 5xx。重试条件区分连接失败、读超时与 4xx 客户端错误;4xx 一般不重试。重试放大下游压力,必须限次并配合熔断。插件配置最大次数、延迟条件与可重试判定。
原理流程
- 配置最大重试次数与退避规则。
- 调用失败判定是否可重试。
- 退避后重试,次数递增。
- 超过次数抛出最后一次异常。
代码或图示
install(Retry) {
maxRetries = 2
// 退避与可重试条件按插件 API 配置
}
常见误区
- 对 POST 非幂等请求盲目重试:重复下单/扣款。
- 重试无退避:下游故障时压力叠加。
追问
- 待确认:Ktor 3 客户端 Retry 插件配置条件与状态码规则,以官方文档核对。
- 重试与熔断关系?答:重试控制单次故障恢复,熔断阻止持续打垮下游。
06.8.1.3-018 异步响应与并发调用如何组织?
一句话结论
客户端调用是挂起函数,可在协程内并发:async 并行发起多个下游调用再 await;并发度受信号量或连接池限制;依赖关系决定串行还是并行,子任务绑定请求作用域便于取消。
概念解释
并行调用减少总体等待,但并发度不能无限制放开。结构化并发保证请求取消时子调用一并取消。下游结果组合按成功/失败分支处理,部分失败要有兜底策略。
原理流程
- 识别可并行的下游调用。
- 在 coroutineScope 内 async 发起。
- await 组合结果。
- 失败按策略降级或抛出。
代码或图示
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 按策略降级;异常信息不直接暴露给最终用户。
概念解释
异常层次:调用层抛请求异常,状态错误由响应对象表达,解码失败是解析异常。分类处理避免把连接问题当业务失败。上层统一映射为自身错误结构与状态码,保留原始原因进日志。
原理流程
- 调用捕获网络/超时异常。
- 响应状态分支区分 4xx/5xx。
- body 解码异常单独处理。
- 映射为业务错误并记录日志。
代码或图示
try {
client.get("/users/1")
} catch (e: HttpRequestTimeoutException) {
// 超时降级
} catch (e: ResponseException) {
// 错误状态码处理
}
常见误区
- 所有异常都重试:4xx 被反复重试无意义。
- 把下游原始错误消息透传给用户:泄露内部细节。
追问
- 待确认:Ktor 3 客户端异常类型名称层次,以官方文档核对。
- 响应体在异常里能取到吗?答:部分异常携带响应对象,按类型判断可读 body。
06.8.1.3-020 客户端资源如何关闭?
一句话结论
客户端实例持有连接池与线程,应用停机时调用 close 释放;实例关闭后不可再发请求;请求级响应体应消费完毕,否则连接无法归还;长生命周期实例绑定应用停止事件关闭。
概念解释
资源释放分两层:单次响应消费归还连接,实例关闭释放池与线程。后台协程持有的客户端引用在停机时一并取消。未关闭实例在容器退出时可能残留线程与连接。
原理流程
- 应用装配期创建实例。
- 请求消费响应体归还连接。
- 停机事件触发 client.close()。
- 等待连接与线程释放完成。
代码或图示
application.monitor.subscribe(ApplicationStopping) {
apiClient.close()
}
常见误区
- 服务退出不 close 客户端:连接与线程残留。
- 关闭后仍有协程调用:失败异常。
追问
- 待确认:close 是否带超时参数,以客户端文档核对。
- 测试中如何避免实例泄漏?答:测试用例结束关闭实例或用测试上下文管理。
06.8.1.3-021 自定义请求头与公共头如何统一添加?
一句话结论
公共头在客户端 defaultRequest 统一附加(追踪标识、客户端版本、内容类型);单次请求需要覆盖时在请求 DSL 内设置;避免在每个调用点重复写公共头,敏感头不得进日志。
概念解释
公共头维度:调用方标识、trace 透传、默认 Accept/Content-Type。单次覆盖用于特殊接口。头命名与下游约定一致,大小写由 HTTP 头规则处理。公共头插件化统一管理便于审计。
原理流程
- 客户端配置 defaultRequest 附加公共头。
- 单次请求按需补充或覆盖。
- 出站插件链组装最终头。
- 日志输出前脱敏敏感头。
代码或图示
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 不再二次编码。
原理流程
- 基础 URL 模板定路径。
- 路径变量替换段值。
- 查询参数按名值添加并编码。
- 客户端组装最终请求行。
代码或图示
client.get("/search") {
parameter("q", "Ktor 客户端")
parameter("tag", "a")
parameter("tag", "b")
}
常见误区
- 手动字符串拼
?q=$value:特殊字符未编码。 - 对已编码值重复编码:参数变成乱码。
追问
- 待确认:多值参数 DSL 写法,以客户端文档核对。
- 路径段含空格/中文怎么办?答:作为路径变量由编码器处理,不要拼进原始模板。
06.8.1.3-023 下载文件与流式响应如何接收?
一句话结论
大文件用流式响应通道逐块读取写盘,不把整个 body 读进内存;读取循环处理背压与取消;完成后关闭流并释放临时文件;超时与大小限制按下载规模配置。
概念解释
小响应可整体读字节;文件下载应边读边写。流未读完连接无法归还池。取消请求时终止写入并清理临时文件。媒体类型与 Content-Disposition 头可用于判定文件名。
原理流程
- 发起下载请求。
- 通过流式通道分块读取。
- 逐块写入目标文件。
- 完成或取消时关闭流、清理临时文件。
代码或图示
val response = client.get<HttpStatement>("/files/report.pdf")
// 流式读取写入目标;具体流式 API 以客户端文档为准
常见误区
- 大文件
readBytes()全量入内存:OOM。 - 流异常不关闭:临时文件与连接泄漏。
追问
- 待确认:Ktor 3 客户端流式接收 API(通道/输出流)名称,以官方文档核对。
- 断点续传支持吗?答:依赖下游 Range 支持,客户端按头与分块实现。
06.8.1.3-024 代理配置如何设置?
一句话结论
按引擎支持配置 HTTP/SOCKS 代理与凭据;代理配置绑定客户端实例,测试与生产环境代理不同时使用独立实例或环境配置;代理连接失败归入网络异常处理。
概念解释
企业内网常通过代理出站;代理地址、端口与凭据从环境配置注入,不写死代码。不同引擎代理实现能力不同,认证方式以引擎为准。直连与代理实例可按目标网络分组。
原理流程
- 从环境读取代理配置。
- 引擎层设置代理与凭据。
- 出站请求经代理转发。
- 代理失败按网络异常降级处理。
代码或图示
engine {
// 代理配置按所选引擎 API;具体参数以引擎文档为准
}
常见误区
- 代理凭据进源码仓库:泄露风险。
- 生产/测试代理混用:环境网络不通。
追问
- 待确认:各客户端引擎代理配置项,以引擎文档核对。
- 绕过代理名单怎么配?答:按引擎支持的 no-proxy 规则配置。
06.8.1.3-025 HTTPS/TLS 与证书信任如何配置?
一句话结论
默认使用系统信任链校验服务端证书;自签内网证书需配置信任材料;不建议在生产关闭证书校验;TLS 版本与密码套件按安全基线配置,代理 TLS 终止位置要明确。
概念解释
TLS 校验防中间人:证书链、主机名有效期都应校验。关闭校验只应出现在受控测试环境。内网自签证书通过自定义信任库引入,证书随轮换更新。引擎 TLS 配置能力各有差异。
原理流程
- 确认链路 TLS 终止位置。
- 生产使用默认信任链或受控信任库。
- 配置最小 TLS 版本基线。
- 证书轮换后更新信任材料。
代码或图示
生产:证书链校验开启,不关闭 hostname 校验
测试:受控自签证书进入信任库
常见误区
- 图省事关闭全部校验:中间人攻击敞口。
- 内网证书过期未更新:调用批量失败。
追问
- 待确认:Ktor 3 客户端引擎 TLS 定制 API,以官方/引擎文档核对。
- 双向认证(mTLS)怎么配?答:客户端提供证书材料,按引擎 TLS 配置实现。
06.8.1.3-026 客户端拦截器如何改造请求与响应?
一句话结论
客户端插件/拦截器在出站前改请求(加头、改参数),入站后改响应(读状态、补充元数据);拦截包裹顺序由安装顺序决定;请求级修改不写入共享实例状态。
概念解释
与服务端管道同构:出站阶段、响应阶段包裹。典型用途:统一加追踪头、记录耗时、错误响应归一。拦截器内不能依赖单次请求的可变状态被其他调用看到。
原理流程
- 插件安装时注册出站/入站拦截。
- 出站前修改请求元数据。
- 调用执行。
- 入站后读取响应并补充处理。
代码或图示
// 示意:请求前加头,响应后记录耗时;具体钩子以插件 API 为准
常见误区
- 在拦截器里缓存当前响应当全局状态:并发串数据。
- 拦截器吞掉异常不记录:失败原因丢失。
追问
- 待确认:客户端插件可用钩子与阶段名称,以官方文档核对。
- 响应体能在拦截器重写吗?答:读取后可派生视图,已提交 body 不可回写,能力以实现为准。
06.8.1.3-027 后台/定时任务中使用客户端要注意什么?
一句话结论
后台协程复用应用级客户端实例,任务绑定应用生命周期;定时任务并发度受控,单次调用设超时与重试;任务异常独立记录,不影响其他任务;停机时取消任务并关闭客户端。
概念解释
后台任务与请求协程不同生命周期:随应用启动/停止。客户端实例共享但调用并发受配额限制。任务自身要有错误隔离、日志与告警,避免一次下游故障拖垮全部定时任务。
原理流程
- 应用启动注册后台任务 Job。
- 任务周期复用客户端发起调用。
- 并发、超时、重试受控。
- 停机取消任务,关闭客户端。
代码或图示
application.monitor.subscribe(ApplicationStarted) {
// 启动后台调度;Job 注册到应用作用域
}
常见误区
- 任务用 GlobalScope:停机取消不到。
- 任务内新建客户端:资源泄漏与池浪费。
追问
- 待确认:Ktor 3 应用启动事件名称,以官方文档核对。
- 任务重叠执行怎么办?答:调度加互斥或上一次未完成则跳过/排队。
06.8.1.3-028 客户端与服务端如何共享序列化配置?
一句话结论
把 DTO 与 Json 配置抽到共享模块,服务端与客户端引用同一套:字段命名、未知键、日期格式一致;避免两端各配一套导致字段丢失或解析偏差;版本演进时共享模块统一升级。
概念解释
往返兼容是共享配置的核心:一端编码的字段另一端能解码。枚举、日期、空值策略尤其容易不一致。共享 DTO 模块同时被服务端与客户端依赖,版本跟随接口契约演进。
原理流程
- 抽取 DTO 与序列化配置到公共模块。
- 服务端接收/响应使用共享类型。
- 客户端请求/响应使用同一类型。
- 契约变更时统一升级两端。
代码或图示
// 共享模块:@Serializable data class UserDto(...)
val sharedJson = Json { ignoreUnknownKeys = true }
常见误区
- 两端字段命名策略不同:响应字段对不上。
- 一端允许未知键另一端严格:新版本字段解析失败。
追问
- 待确认:项目内共享模块位置以实际工程结构为准,本节不指定仓库路径。
- 接口多版本兼容怎么办?答:DTO 按版本分离,未知键策略显式约定。
06.8.1.3-029 连接泄漏与响应未消费有什么表现?
一句话结论
响应体未读取或流未关闭时,连接无法归还池,表现为连接数持续增长、池耗尽、新请求排队等待;排查看连接池指标、响应消费路径与异常中断路径是否关闭资源。
概念解释
连接复用要求 body 被消费或释放。异常分支、提前 return、流未关闭都会留下未释放连接。高并发下泄漏逐步累积,最终表现为请求超时而非即时报错。
原理流程
- 发起请求取得响应。
- 正常路径消费 body。
- 异常/提前退出路径未消费或未关闭。
- 连接滞留池中不可用,池耗尽。
代码或图示
排查:连接数曲线 / 池等待队列 / 响应读取代码路径 / 流关闭点
常见误区
- 只在成功路径读 body:异常分支泄漏。
- 流式读取循环被取消不关闭:连接与文件句柄残留。
追问
- 如何验证响应被消费?答:压测观察连接归还与池空闲数,代码走查所有分支。
- 待确认:客户端响应自动释放策略,以引擎实现核对。
06.8.1.3-030 客户端 API 与版本基线有哪些核对点?
一句话结论
升级或接入前核对:客户端引擎清单、插件坐标与配置项、请求/响应 DSL 方法名、异常类型层次、流式接收 API;不确定处标「待确认」,以 Ktor 3 官方文档与依赖仓库为准,不编造版本号。
概念解释
客户端 API 在大版本间有演进:插件拆分、钩子改名、引擎调整。核对路径:编译告警 -> 官方文档 -> 依赖坐标 -> 运行用例。答案中引用具体类名/属性前应确认版本。
原理流程
- 对齐 Ktor 3 与 Kotlin 2.x 基线。
- 查官方客户端文档确认引擎与插件。
- 核对 DSL 与异常类型签名。
- 用成功/超时/错误状态用例验证。
代码或图示
核对清单:引擎 / 插件坐标 / DSL 方法 / 异常类型 / 流式 API
常见误区
- 凭旧版本笔记写 API 名:编译或运行期报错。
- 只测成功路径:超时与错误状态未验证。
追问
- 待确认:Ktor 3 客户端各插件确切坐标,以 ktor.io 文档为准。
- 版本不兼容怎么处理?答:对齐基线版本,不混用跨大版本客户端依赖。
06.8.1.3-031 客户端压测关注哪些指标?
一句话结论
关注吞吐、P50/P95/P99 延迟、连接池占用、超时率与重试率;区分自身等待与下游耗时;按下游容量设定并发与超时,观察池排队与错误率拐点。
概念解释
客户端指标反映依赖调用健康:延迟分布比平均值重要,长尾影响整体接口 SLA。连接池占用与等待队列定位资源瓶颈;重试率高说明下游不稳定或超时过紧。
原理流程
- 压测场景覆盖典型报文与并发。
- 采集延迟分位、池占用、错误与重试。
- 找拐点:延迟随并发恶化的位置。
- 调整池、超时与并发上限。
代码或图示
指标:QPS / 延迟分位 / 连接池空闲与等待 / 超时率 / 重试率 / 错误状态分布
常见误区
- 只看平均延迟:长尾请求被掩盖。
- 压测不隔离下游:自身容量判断失真。
追问
- 下游慢怎么隔离?答:舱壁池 + 超时 + 降级,避免拖垮主流程。
- 待确认:客户端可观测指标暴露方式,以插件/引擎能力核对。
06.8.1.3-032 场景:调用第三方 API 的客户端如何装配?
一句话结论
按下游隔离独立客户端实例:配置专属超时、连接池、认证与序列化;凭据从配置注入;错误分类处理(重试/降级/告警);可观测指标与日志脱敏;停机统一关闭实例。
概念解释
第三方调用不稳定与策略特殊,隔离避免影响内部调用。装配包括引擎选择、超时分级、认证头、序列化兼容、重试熔断与指标。第三方契约(字段、错误码、限流)单独维护适配层。
原理流程
- 定义下游适配层与 DTO。
- 装配隔离客户端实例与策略。
- 调用封装分类处理与降级。
- 指标、日志与停机释放配套。
代码或图示
适配层:DTO 映射 -> 隔离客户端 -> 超时/重试/降级 -> 指标与脱敏日志
常见误区
- 第三方与内部服务共用实例:池与超时互相拖累。
- 透传第三方错误消息给用户:泄露与误导。
追问
- 第三方限流怎么应对?答:自身并发配额 + 退避重试 + 降级,按对方配额调整。
- 待确认:熔断组件在项目生态中的选型,按实际依赖核对。
06.8.1.3-033 服务端 WebSocket 路由如何注册?
一句话结论
在 routing 中用 webSocket 动词注册 WS 路由,闭包内获得会话对象处理收发;握手仍走常规 HTTP 管道,可挂认证与来源校验;路径参数与普通路由一致。
概念解释
WebSocket 路由节点与 HTTP 方法节点并列;升级成功后进入会话协程。注册位置决定握手前可套用的拦截(认证、CORS)。WS 路径与普通 HTTP 路径可共存于同一前缀。
原理流程
- routing 内
webSocket("/path") { 会话处理 }。 - 握手请求经过前置管道拦截。
- 升级成功建立会话。
- 闭包协程内收发消息直至关闭。
代码或图示
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 头转发,否则握手失败。
原理流程
- 客户端发起带 Upgrade: websocket 的 HTTP 请求。
- 服务端管道校验认证与来源。
- 返回 101 切换响应,协议升级。
- 进入 WS 帧会话生命周期。
代码或图示
HTTP 握手(101 Switching Protocols) -> WebSocket 帧通道
常见误区
- 网关不透传 Upgrade 头:握手被当普通 HTTP 处理失败。
- 以为认证在每帧重复校验:握手通过后帧通道不再走 HTTP 认证管道。
追问
- 待确认:101 响应与升级头的服务端行为,以引擎/WS 文档核对。
- 握手失败返回什么?答:按 HTTP 错误状态拒绝,不建立会话。
06.8.1.3-035 会话对象与消息收发 API 是什么?
一句话结论
会话对象提供发送文本/二进制帧与接收帧流的能力;接收通常以通道或迭代形式消费,发送为挂起方法;会话持有连接状态,关闭后不可再收发。
概念解释
会话封装单个 WS 连接:发送方写帧,接收方读帧流。消息编解码在会话层完成(文本 JSON、二进制字节)。收发循环需处理帧类型、异常与关闭原因。具体 API 名称以版本为准。
原理流程
- 握手成功得到会话对象。
- 通过接收遍历读取入站帧。
- 业务处理后调用发送写出帧。
- 连接关闭会话结束。
代码或图示
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)跑在文本或二进制帧之上。
原理流程
- 入站帧按类型分派。
- 文本帧解码为字符串/JSON。
- 二进制帧按约定格式解析字节。
- 控制帧由会话层处理心跳与关闭。
代码或图示
数据帧:Text / Binary
控制帧:Close / Ping / Pong
常见误区
- 把业务消息塞进控制帧:协议用途错误。
- 不区分文本与二进制解析:格式错乱。
追问
- 待确认:Ktor 3 帧类型类名与读取 API,以官方 WS 文档核对。
- 帧分片怎么处理?答:由会话层按协议重组,应用读到完整消息,能力以实现为准。
06.8.1.3-037 会话生命周期与关闭原因如何理解?
一句话结论
会话从握手成功开始,到正常关闭、对端关闭、网络断开或异常结束;关闭带原因码与可选描述;生命周期内的资源(订阅、关联状态)必须在结束时清理,避免幽灵会话。
概念解释
结束路径不止正常关闭:客户端断网、服务端重启、代理超时都会终止会话。服务端要在会话结束回调中移除在线集合、取消订阅、释放关联资源。关闭原因码用于区分正常退出与异常断开。
原理流程
- 握手成功加入会话管理。
- 收发循环处理消息。
- 收到关闭帧/异常/取消进入结束流程。
- 清理资源并从在线集合移除。
代码或图示
webSocket("/ws") {
try {
// 收发循环
} finally {
// 移除会话、取消订阅
}
}
常见误区
- 只处理正常关闭:异常断开会话残留在在线集合。
- 会话结束不清理订阅:消息推给已关闭连接。
追问
- 待确认:会话结束回调与关闭原因读取 API,以官方文档核对。
- 断线后会话状态保留多久?答:重新连接后按业务标识恢复,不依赖旧会话对象。
06.8.1.3-038 心跳 Ping/Pong 如何配置?
一句话结论
心跳通过周期性 Ping 帧与 Pong 响应检测存活;服务端或客户端一方发起,配置间隔与超时;超时未收到 Pong 判定断线并清理会话;心跳间隔按连接存活需求与代理超时调整。
概念解释
长连接在空闲时没有业务帧,需要心跳识别半死连接(网络中断但 TCP 未通知)。心跳间隔要短于代理/网关的空闲断开时间。Pong 应答由协议层自动或应用层处理,按实现核对。
原理流程
- 配置心跳间隔与等待超时。
- 空闲时发送 Ping。
- 等待 Pong,超时判定断线。
- 关闭并清理会话。
代码或图示
心跳:Ping 间隔 < 代理空闲超时;Pong 超时 -> 判定死连接
常见误区
- 心跳间隔长于代理断开:连接被中间层静默关闭。
- 心跳任务不随会话取消:会话结束后仍发 Ping。
追问
- 待确认:Ktor 3 心跳配置入口与自动 Pong 行为,以官方文档核对。
- 心跳消息算业务流量吗?答:控制帧不计业务消息量。
06.8.1.3-039 断线与异常如何处理?
一句话结论
收发循环捕获连接异常与协程取消,进入统一结束流程:移除会话、取消订阅、记录断开原因;异常分类区分客户端主动退出、网络中断与服务端错误,避免一个异常拖垮会话管理。
概念解释
异常来源:网络读写失败、对端异常关闭、消息解析错误、会话取消。处理原则:任何退出路径都走同一清理流程;解析错误可单帧忽略,连接错误终止会话。日志记录会话标识与原因,不记敏感消息。
原理流程
- 循环内捕获异常与取消。
- 分类判断:解析错误/连接错误/主动关闭。
- 统一清理关联资源。
- 记录日志并通知上层会话状态变更。
代码或图示
try {
incoming.consumeEach { /* ... */ }
} catch (e: Throwable) {
// 记录断开原因,不抛出导致管理协程崩溃
} finally {
cleanup()
}
常见误区
- 异常未捕获导致会话管理协程崩溃:后续连接受影响。
- 解析错误直接断连:单条坏消息不应杀掉整个连接。
追问
- 待确认:会话异常类型与取消传播行为,以源码/文档核对。
- 断线重连由谁负责?答:客户端侧重连,服务端识别重连后的身份恢复状态。
06.8.1.3-040 会话状态如何管理(在线集合)?
一句话结论
服务端用线程安全集合维护会话标识到会话的映射,按用户/租户分组;会话结束时移除;集合只存必要引用,不存大对象;多实例下会话分布在各节点,广播需经消息中间件跨节点。
概念解释
在线集合支撑点对点推送与在线状态展示。并发连接增减必须用并发集合或加锁;会话引用泄漏会阻止会话对象回收。单节点集合无法跨实例推送,分布式场景用订阅消息队列同步。
原理流程
- 握手成功按身份加入集合。
- 业务推送从集合取会话。
- 会话结束从集合移除。
- 多实例经中间件发布消息到目标节点。
代码或图示
val sessions = ConcurrentHashMap<String, MutableSet<WebSocketSession>>()
常见误区
- 用普通 ArrayList 存会话:并发增减竞态。
- 会话结束不移除:集合膨胀、推送幽灵连接。
追问
- 待确认:项目在线状态是否走外部存储,按架构设计核对。
- 一个用户多设备连接怎么管?答:按用户标识维护会话集合,推送遍历全部设备。
06.8.1.3-041 广播与点对点消息推送如何实现?
一句话结论
点对点按用户标识从会话集合取目标会话发送;广播遍历全部在线会话或按分组筛选;发送失败(连接已断)触发移除;多实例广播通过消息中间件分发到各节点本地会话。
概念解释
推送路由:业务事件 -> 查找在线会话 -> 发送帧。发送前检查会话存活,发送异常即清理。广播注意消息量与连接数关系,必要时分批与限速。订阅关系(频道、群组)在会话管理层维护。
原理流程
- 业务事件携带目标标识或分组。
- 本地集合查会话;跨节点经中间件投递。
- 遍历发送,失败标记移除。
- 订阅变更时更新分组关系。
代码或图示
点对点:userId -> sessions[userId]
广播:事件 -> 节点本地全部会话 / 分组订阅集合
常见误区
- 对已关闭会话发送不捕获异常:推送协程中断。
- 单节点集合做全量广播:多实例用户收不到。
追问
- 推送顺序有要求吗?答:同会话内按顺序发送,跨会话不保证全局顺序。
- 待确认:项目推送通道(WS/SSE/中间件)选型,按架构核对。
06.8.1.3-042 消息编解码与 JSON 序列化如何配合?
一句话结论
文本帧内约定 JSON(或其他编码)消息结构,收发时用共享序列化配置编解码;消息包带类型标识便于分派;解码失败返回错误帧或忽略,不抛出断开连接;DTO 与客户端/前端共享契约。
概念解释
WS 帧本身不定义消息格式,应用层自选 JSON/Protobuf/文本协议。消息分派按 type 字段路由到处理器。序列化配置与 HTTP 接口保持一致,枚举、日期、空值策略统一。
原理流程
- 定义消息信封(类型、标识、载荷)。
- 入站文本帧反序列化为信封。
- 按类型分派处理器。
- 出站对象序列化为文本帧发送。
代码或图示
@Serializable
data class WsEnvelope(val type: String, val payload: String? = null)
常见误区
- 消息无类型标识:分派靠猜测,扩展困难。
- 解码异常直接断连:单条坏消息影响长连接。
追问
- 二进制帧选什么格式?答:Protobuf 等紧凑格式,按项目契约约定。
- 待确认:WS 会话内序列化复用 ContentNegotiation 配置的方式,以文档核对。
06.8.1.3-043 并发写会话需要注意什么?
一句话结论
同一会话的发送应通过单一协调者串行化,避免多协程并发写导致帧交错;不同会话可并发发送;发送前检查存活状态,写异常触发清理;共享订阅回调向会话写消息要走同步队列。
概念解释
WS 帧通道对并发写的安全性依实现而定,保守做法是每会话一个发送协程或加锁。业务事件回调可能来自不同线程/协程,提交到会话队列由发送协程消费。帧交错会破坏消息边界。
原理流程
- 每会话维护消息队列与发送协程。
- 事件回调入队,不直接写帧。
- 发送协程串行出队发送。
- 关闭时停止队列并清理。
代码或图示
事件回调 -> 会话队列 -> 单一发送协程 -> 帧写出
常见误区
- 多个业务协程直接并发 send:帧交错损坏消息。
- 发送不检查存活:向关闭连接写异常。
追问
- 待确认:Ktor 3 会话 send 的并发安全性,以源码/文档核对。
- 队列满了怎么办?答:按策略丢弃旧消息或背压控制,避免内存膨胀。
06.8.1.3-044 WebSocket 与 SSE 如何取舍?
一句话结论
双向实时交互选 WebSocket;服务端单向推送、客户端只读消息选 SSE;SSE 基于普通 HTTP,实现简单、自动重连友好,受代理缓冲与浏览器特性限制;双向写需求不能用 SSE 替代。
概念解释
SSE 是服务器到客户端的单向文本流;WebSocket 全双工。选型看交互方向、代理兼容性、实现成本与重连需求。消息格式两者都是文本为主,SSE 有事件格式与标识约定。
原理流程
- 判断是否需要客户端实时上行。
- 仅下行推送:评估 SSE。
- 双向交互:选 WebSocket。
- 核对代理与浏览器兼容后定稿。
代码或图示
WebSocket:双向、二进制可、自定义协议
SSE:单向下行、HTTP 流、事件标识与自动重连
常见误区
- 用 SSE 做客户端实时上报:方向不匹配,仍需另开 HTTP。
- 复杂双向协议硬塞 SSE:轮询兜底导致实时性差。
追问
- 待确认:项目对 SSE 客户端支持范围,按目标浏览器/环境核对。
- 两者能并存吗?答:可按场景分通道,服务端分别实现。
06.8.1.3-045 客户端 WebSocket 如何连接?
一句话结论
客户端用 WS 客户端工厂建立连接:指定 URL、握手头与子协议,连接成功得到会话对象;连接失败按网络异常处理;生命周期与调用协程绑定,结束时关闭会话。
概念解释
客户端 WS 握手同样是 HTTP 升级,可携带认证头。连接配置包含超时、心跳、重连策略。会话对象用于收发,协程取消时连接关闭。具体工厂与 API 名称以版本为准。
原理流程
- 创建 WS 客户端或复用客户端实例。
- 发起连接,带握手头与子协议。
- 握手成功进入会话协程。
- 收发循环,结束关闭连接。
代码或图示
client.webSocket(path = "/ws") {
send("hello")
incoming.consumeEach { /* ... */ }
}
常见误区
- 连接协程不结束:会话保持泄漏。
- 握手认证头漏带:握手阶段被拒绝。
追问
- 待确认:Ktor 3 客户端 webSocket 扩展与会话类型,以官方文档核对。
- WS 客户端复用 HTTP 客户端实例吗?答:按实现可复用配置,连接独立管理,以文档核对。
06.8.1.3-046 客户端会话收发循环如何组织?
一句话结论
连接后在协程内并行处理:发送循环消费出站消息队列,接收循环读入站帧;两者随会话结束退出;分派入站消息到业务处理器,出站消息从业务事件队列取。
概念解释
双向通道需要两条处理线:收与发可在同一协程内交替,或拆分两个子协程。结构化并发保证任一方结束都能取消另一方。消息编解码在循环边界完成,业务逻辑不接触帧细节。
原理流程
- 连接成功启动收发协程。
- 接收循环读取帧并分派。
- 发送循环取出站队列写帧。
- 关闭/异常时两条线一并退出。
代码或图示
webSocket("/ws") {
launch { outgoing.consumeEach { send(it) } }
incoming.consumeEach { handle(it) }
}
常见误区
- 收发混在单循环阻塞:出站消息被接收等待卡住。
- 子协程脱离会话作用域:结束后残留。
追问
- 待确认:会话内启动子协程的作用域约束,以源码核对。
- 消息顺序怎么保证?答:单连接内按帧顺序,出站队列保证发送次序。
06.8.1.3-047 客户端心跳与断线重连如何配合?
一句话结论
心跳保活检测死连接;断线后按退避策略重连,重连前重新握手认证;重连期间消息做排队或丢弃策略;指数退避加抖动避免雪崩,连接恢复后恢复订阅与状态同步。
概念解释
重连是客户端职责:检测断开 -> 等待退避 -> 重新连接 -> 恢复会话状态。心跳超时与读写异常都触发重连。连续失败次数有限制,超过后上报告警。重连不要立刻疯狂重试。
原理流程
- 心跳维持连接存活。
- 检测断线(异常/超时/关闭帧)。
- 退避等待后重新握手。
- 恢复订阅、补拉缺失状态。
代码或图示
断线 -> 退避(指数+抖动) -> 重连握手 -> 状态恢复 -> 继续收发
常见误区
- 断线立即重连:服务端故障时重试风暴。
- 重连不重新认证:凭据过期后握手失败。
追问
- 待确认:Ktor WS 客户端是否内置心跳与重连配置,以文档核对;多数场景需自实现重连循环。
- 重连期间上行消息怎么办?答:按业务选择短暂排队或丢弃,避免无限积压。
06.8.1.3-048 重连退避策略怎么设计?
一句话结论
指数退避:间隔随失败次数翻倍,加随机抖动打散并发重连;设最大间隔与重试上限;连接成功重置计数;区分可重连网络错误与不可重连业务拒绝(如认证失败不重试)。
概念解释
退避保护故障中的服务端:避免大量客户端同步重试。抖动让重连时刻分散。认证失败、协议错误等不应重连;网络抖动、服务端重启属于可重试场景。上限后进入告警人工介入。
原理流程
- 断线分类:可重试/不可重试。
- 可重试:计算退避间隔(指数 + 抖动)。
- 等待后重连,成功重置计数。
- 超过上限停止重试并告警。
代码或图示
delay = min(base * 2^attempt, maxDelay) + randomJitter
常见误区
- 固定间隔重试:故障期同步冲击。
- 对 401/403 握手失败无限重连:凭据问题需人工介入。
追问
- 群组客户端同时重连怎么办?答:抖动 + 限速,服务端配合限流。
- 退避状态存哪里?答:客户端连接管理对象内,随应用生命周期。
06.8.1.3-049 子协议与握手头如何处理?
一句话结论
WebSocket 子协议在握手时通过 Sec-WebSocket-Protocol 协商,服务端选定后双方按该协议通信;自定义握手头携带认证、追踪标识等;子协议与消息格式契约保持一致。
概念解释
子协议让同一通道承载约定格式(如 chat、rpc 版本)。握手头只在升级请求中出现,连接建立后不重复携带。认证信息在握手阶段校验,后续帧不再走 HTTP 头。
原理流程
- 客户端握手提交支持的子协议列表与头。
- 服务端选定子协议并回握手响应。
- 双方按选定协议编解码。
- 业务消息遵循协议契约。
代码或图示
握手:Sec-WebSocket-Protocol 协商 + 自定义认证/追踪头
常见误区
- 连接建立后再想加握手头:已无法补充,需重连。
- 子协议版本两端不一致:消息解析错乱。
追问
- 待确认:Ktor 3 子协议配置与读取 API,以官方文档核对。
- 多版本协议兼容怎么做?答:子协议标识版本,服务端按版本分派处理器。
06.8.1.3-050 二进制帧如何处理?
一句话结论
二进制帧载荷为字节,按约定格式(Protobuf、自定义二进制)解析;读取前校验长度与格式;二进制比文本紧凑,适合高频消息;编解码库选择与跨端契约配套。
概念解释
二进制帧不强制 UTF-8;应用层格式自定。解析失败要能定位坏帧,不拖垮连接。与文本帧相比体积小但可读性差,调试时需转码查看。消息信封仍需类型与版本标识。
原理流程
- 接收 Binary 帧取得字节载荷。
- 按约定格式反序列化。
- 校验类型与版本。
- 出站对象序列化为二进制帧发送。
代码或图示
is Frame.Binary -> {
val bytes = frame.readBytes()
// 按 Protobuf 等格式解析
}
常见误区
- 二进制载荷当文本解码:乱码与解析异常。
- 不校验长度:恶意大帧占用内存。
追问
- 待确认:帧字节读取 API 名称,以文档核对。
- 文本与二进制能混用吗?答:协议约定为主,混用需消息类型区分。
06.8.1.3-051 客户端会话关闭与资源释放怎么做?
一句话结论
主动关闭发送关闭帧并等待对端响应;协程取消时强制释放连接;出站队列、订阅回调与缓冲消息在结束时清理;关闭异常记录但不抛出到管理上层。
概念解释
关闭分主动优雅关闭与异常断开。优雅关闭走协议关闭握手;异常路径直接释放套接字。关联资源(队列、订阅、状态订阅)在 finally 中清理,避免客户端侧泄漏。
原理流程
- 业务结束或检测断线。
- 优雅关闭:发 Close 帧等待响应。
- 取消收发子协程。
- 清理队列与订阅,释放连接。
代码或图示
try {
// 收发循环
} finally {
outgoing.cancel()
// 取消订阅回调
}
常见误区
- 只关闭套接字不等关闭握手:对端状态不一致。
- 队列回调持有会话引用:连接释放不掉。
追问
- 待确认:关闭帧发送与原因码 API,以官方文档核对。
- 重连前旧会话资源是否清理干净?答:必须先完成旧会话清理再建新连接。
06.8.1.3-052 WebSocket 连接鉴权怎么做?
一句话结论
认证在握手请求阶段完成:凭据通过握手头、Cookie 或握手前的临时票据携带;握手通过后建立会话,帧通道内不再重复 HTTP 认证;会话内角色与权限由握手产出的主体携带。
概念解释
握手是唯一的 HTTP 语义阶段,认证拦截器在此生效。凭据形式:Bearer 头、Cookie、一次性握手票据(避免 URL 带令牌进日志)。连接建立后切换到会话主体,后续操作按主体授权。
原理流程
- 握手请求携带凭据。
- 前置认证拦截校验并产出主体。
- 握手通过,主体绑定会话。
- 帧消息按会话主体授权。
代码或图示
握手:认证头/Cookie/票据 -> 校验 -> 主体绑定会话
帧阶段:按主体授权,不再走 HTTP 认证管道
常见误区
- 令牌放 URL 查询参数:进访问日志与代理记录。
- 握手通过后不在帧层做权限校验:依赖连接时的身份即可,但权限变更需重连生效。
追问
- 待确认:握手阶段复用 Authentication 插件的方式,以官方文档核对。
- 长连接期间权限变更怎么办?答:重连刷新主体,或会话内定期校验。
06.8.1.3-053 消息背压与消费速度如何处理?
一句话结论
消费慢于生产时需要背压控制:限制出站/入站队列长度,溢出按策略丢弃或阻塞;慢消费者不影响其他连接;消息积压指标监控,避免内存随连接数膨胀。
概念解释
WS 是长连接,消息速率不匹配会形成队列积压。背压手段:有界队列、发送慢时降低生产速率、非关键消息丢弃。每条会话独立队列,避免单消费者拖垮全局。
原理流程
- 每会话队列设上限。
- 入站/出站超阈值执行策略。
- 监控积压深度与丢弃数。
- 慢消费者反馈到生产限速。
代码或图示
队列有界:满 -> 丢弃旧消息 / 阻塞生产 / 断开策略
常见误区
- 无界队列缓存消息:慢连接拖垮服务端内存。
- 一条慢连接占用全局消费者:其他连接排队。
追问
- 待确认:Ktor WS 通道是否提供队列容量配置,以文档核对。
- 关键消息能丢吗?答:按业务分级,关键消息需持久化或重传机制。
06.8.1.3-054 WebSocket 相关 API 有哪些待核对点?
一句话结论
接入前核对:服务端/客户端 WS 注册与扩展方法名、会话类型与收发 API、帧类型读取、心跳配置、子协议协商、关闭原因码与异常类型;不确定处标待确认,以 Ktor 3 官方文档为准。
概念解释
WS API 在版本间可能调整扩展函数名与会话接口。核对清单按握手、收发、控制帧、生命周期四块组织。代码引用具体符号前先编译与文档双重确认。
原理流程
- 对齐 Ktor 3/Kotlin 基线。
- 查官方 WS 文档核对符号。
- 编译验证 unresolved 告警。
- 用连接、收发、关闭用例运行验证。
代码或图示
核对块:握手注册 / 会话收发 / 帧类型 / 心跳 / 子协议 / 关闭与异常
常见误区
- 凭旧版本笔记写扩展函数名:编译失败。
- 假设心跳自动开启:默认行为需核对。
追问
- 待确认:确切符号清单见 ktor.io WS 章节,升级版本时复核。
- 引擎对 WS 支持有差异吗?答:连接升级与并发行为依引擎实现核对。
06.8.1.3-055 SSE 服务端如何推送事件?
一句话结论
SSE 在单个 HTTP 响应中保持文本流,按事件格式(事件类型、数据、标识、重试间隔)逐行写出;响应不关闭,服务端持续写事件;客户端按流读取,适合单向下行推送。
概念解释
SSE 响应 Content-Type 为 event-stream,事件以 data: 等字段行组织,空行分隔事件。服务端把业务事件写入响应通道;连接生命周期对应一次 HTTP 请求。事件标识用于断点重连。
原理流程
- 客户端发起 SSE 连接请求。
- 服务端设置 event-stream 响应头。
- 业务事件到达时格式化写入流。
- 连接关闭结束本次推送。
代码或图示
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 实现与运维复杂度更高。同一系统可按场景分别使用。
原理流程
- 列交互方向与消息格式需求。
- 评估代理缓冲与浏览器兼容。
- 对比实现与重连成本。
- 选定通道或组合使用。
代码或图示
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 去重。
原理流程
- 推送事件写入 id。
- 断线后客户端带 Last-Event-ID 重连。
- 服务端查该 id 之后的事件补发。
- 客户端去重并继续消费。
代码或图示
事件 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 自动重连,自实现客户端需处理重连与标识。错误与连接关闭事件单独处理。
原理流程
- 发起 SSE 请求并保持响应流。
- 逐行读取事件字段。
- 空行触发事件分派。
- 断线带 Last-Event-ID 重连。
代码或图示
行缓冲 -> 字段解析 -> 空行成事件 -> 分派处理器
常见误区
- 按完整 JSON 一次性读取:流事件被攒批。
- 不处理多行 data:事件载荷截断。
追问
- 待确认:Ktor 客户端 SSE 消费 API 是否内置,以官方文档核对;否则按流式响应自行解析。
- 浏览器 EventSource 限制?答:连接数、头定制能力受浏览器规范约束。
06.8.1.3-059 SSE 有哪些兼容性与代理缓冲问题?
一句话结论
部分代理/网关默认缓冲响应,导致 SSE 事件不能实时下发,需关闭缓冲或按流式透传;浏览器对 EventSource 连接数与自定义头有限制;HTTPS 与重连行为受中间层影响,部署时需验证端到端延迟。
概念解释
缓冲是 SSE 最常见部署问题:Nginx/网关按响应缓冲攒批。透传配置包括关闭 buffering、设置正确 Content-Type 与不压缩流式响应。浏览器侧连接上限与鉴权头限制影响接入方案。
原理流程
- 部署链路核对代理缓冲配置。
- 确保流式响应不被压缩/缓存攒批。
- 验证端到端事件延迟。
- 浏览器限制在方案设计时规避。
代码或图示
排查:事件延迟 -> 代理 buffering / 压缩 / 缓存策略 / 连接数上限
常见误区
- 本地直连正常就上线:网关缓冲在生产才暴露。
- 对 SSE 响应启用压缩:缓冲与实时性受损。
追问
- 待确认:项目网关 SSE 透传配置项,按实际代理核对。
- 连接数上限怎么办?答:合并推送通道或改用 WS,按浏览器/环境限制评估。
06.8.1.3-060 SSE 适用场景是什么?
一句话结论
适合服务端单向推送:通知、行情增量、进度更新、状态广播;客户端不需要实时上行、消息以文本事件为主、可接受断线重连补齐的场景;双向交互或高频二进制消息选 WebSocket。
概念解释
场景匹配看方向、频率、格式与重连要求。内部进度条、公告推送类用 SSE 实现成本低;聊天、协作编辑、实时控制类双向场景用 WS。也可 SSE 下行 + 普通 HTTP 上行组合。
原理流程
- 梳理消息方向与频率。
- 评估文本格式与重连补齐需求。
- 匹配 SSE 能力边界。
- 不匹配则选 WS 或组合方案。
代码或图示
SSE:通知 / 进度 / 行情 / 状态广播
WS:聊天 / 协作 / 双向控制 / 高频二进制
常见误区
- 低频单向推送也上 WS:运维复杂度不必要。
- 上行简单请求也走 WS:HTTP 接口足够。
追问
- 待确认:项目实时消息通道选型记录,按架构文档核对。
- 混合架构怎么切?答:SSE 下行通知 + HTTP 上报,按消息类型分通道。
06.8.1.3-061 testApplication 如何构造测试?
一句话结论
testApplication 装配模块函数构造测试环境,提供测试客户端发起请求;不绑定真实端口与网络栈,在内存管道中推进;依赖替换为测试替身,断言响应行为。
概念解释
测试应用复用生产模块装配逻辑,替换外部依赖。测试上下文管理应用生命周期与清理。测试用例通过客户端请求驱动 Handler,覆盖路由、认证与插件行为。具体 API 名称以版本为准。
原理流程
- 调用 testApplication 装配模块。
- 注入测试替身依赖。
- 测试客户端发起请求。
- 断言响应并清理测试状态。
代码或图示
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 按类型反序列化后比对字段。测试覆盖成功、参数非法、未认证等分支,断言错误结构与错误码。
原理流程
- 构造请求方法、路径与载荷。
- 发起调用取得响应。
- 断言状态码与头。
- 解析 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。解析失败的响应结构与字段错误列表同样断言。
原理流程
- 准备合法与非法参数用例。
- 发起对应请求。
- 断言成功响应或 400 错误。
- 核对校验字段与错误码。
代码或图示
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,有效断言放行;主体角色与数据归属分支同样覆盖;枚举受保护清单避免漏测。
概念解释
认证测试必须包含负向用例:未带凭据、过期/伪造令牌、无权限角色。只测登录态会漏掉未保护接口。测试替身可构造主体,避免依赖真实认证服务。
原理流程
- 列出受保护路由清单。
- 匿名与无效凭据请求断言拒绝。
- 有效主体请求断言放行。
- 越权主体断言 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)与响应处理分支;真实网络兼容仍需集成测试。
原理流程
- 客户端构造时注入 MockEngine。
- 配置请求匹配到预设响应。
- 调用触发 Mock 响应。
- 断言请求构造与响应处理。
代码或图示
val client = HttpClient(MockEngine) {
// MockEngine 配置按官方测试文档
}
常见误区
- 用 MockEngine 验证超时/连接池:引擎行为未真实执行。
- Mock 响应与真实契约不一致:集成时暴露问题。
追问
- 待确认:Ktor 3 MockEngine 配置与请求拦截 API,以官方测试文档核对。
- 什么测试需要真实引擎?答:端到端网络、TLS、连接复用验证。
06.8.1.3-066 如何注入测试替身依赖?
一句话结论
模块函数接收依赖工厂或接口,测试装配时替换为内存实现、Mock 桩;替身实现同一接口,记录调用参数并返回预设数据;外部消息、缓存、时间等边界都可替身化。
概念解释
可测试性来自依赖倒置:业务依赖接口,生产注入真实实现,测试注入替身。替身分类:返回固定数据的桩、记录调用的 Mock、模拟失败的故障实现。装配入口统一,不通过全局查找。
原理流程
- 生产模块定义依赖接口参数。
- 测试装配传入替身实现。
- 用例断言替身收到的调用。
- 模拟下游失败验证降级分支。
代码或图示
fun Application.configureUsers(repository: UserRepository) { /* ... */ }
// 测试:configureUsers(InMemoryUserRepository)
常见误区
- 服务内硬编码 new 真实客户端:测试无法替换。
- 替身不模拟失败路径:降级与重试分支未覆盖。
追问
- 时间/随机数怎么替身?答:抽象时钟与随机源接口,测试注入固定值。
- 消息队列替身怎么做?答:内存实现收发接口,断言发布消息。
06.8.1.3-067 如何测试异常映射与状态码?
一句话结论
触发领域异常与反序列化错误,断言映射后的状态码、错误码与响应结构;覆盖未预期异常兜底 500;日志记录断言不强制,但异常分类必须可区分。
概念解释
异常映射测试验证 StatusPages 与错误归一:业务异常 -> 对应 4xx,系统异常 -> 500。错误 body 的字段错误列表、中性消息格式断言。测试替身抛出指定异常触发映射链。
原理流程
- 替身服务抛出各类业务异常。
- 发起请求触发处理链。
- 断言状态码与错误结构。
- 验证兜底异常不泄露堆栈。
代码或图示
// 替身抛 NotFoundException -> 断言 404 与错误码
assertEquals(HttpStatusCode.NotFound, res.status)
常见误区
- 只测正常成功路径:异常映射未验证。
- 断言响应含内部堆栈:生产安全问题。
追问
- 待确认:异常类型到状态码的映射测试入口,与 StatusPages 实现核对。
- 异步子协程异常怎么测?答:触发后等待收敛,断言最终响应或日志。
06.8.1.3-068 WebSocket 与 SSE 如何测试?
一句话结论
WS 测试在测试环境建立模拟会话,收发帧断言消息分派与清理;SSE 测试读取事件流断言事件格式与标识;断开重连、心跳超时等路径用可控时钟/模拟连接验证,不依赖真实端口。
概念解释
长连接测试关注:握手认证、消息编解码、收发循环、结束清理、断线重连。测试替身模拟对端帧与断开事件。流类响应按读取循环断言逐事件输出,而非整体 body 比对。
原理流程
- 测试装配应用与 WS/SSE 路由。
- 建立测试会话或流连接。
- 发送入站事件断言出站响应。
- 模拟断开断言清理与重连逻辑。
代码或图示
WS:测试会话 -> 入站帧 -> 断言出站帧 -> 关闭清理
SSE:读取事件流 -> 断言 event/data/id 字段
常见误区
- 长连接用普通请求断言整体响应:流未读取完。
- 不验证会话清理:在线集合泄漏未发现。
追问
- 待确认:Ktor 3 WS/SSE 测试辅助 API,以官方测试文档核对。
- 心跳超时怎么测?答:用可控时间源模拟超时,避免真实等待拉长测试。
06.8.1.3-069 测试配置与环境如何隔离?
一句话结论
测试使用独立配置:内存替身、固定端口/无端口、测试日志级别;不连接生产与共享测试环境数据库;配置通过装配入口注入,不依赖本机环境变量残留;测试数据独立准备与清理。
概念解释
环境隔离保证用例可重复执行:无外部状态依赖、无本机路径与账号配置。测试配置与生产配置分离,替身覆盖外部依赖。并行测试之间数据不互相干扰。
原理流程
- 测试装配加载测试配置。
- 外部依赖替换为内存替身。
- 用例准备独立数据。
- 结束清理测试状态。
代码或图示
隔离项:配置源 / 外部服务 / 数据库 / 缓存 / 日志 / 测试数据
常见误区
- 测试读本机开发配置:换机器用例失败。
- 共享测试库数据残留:用例顺序依赖。
追问
- 待确认:项目测试配置文件位置,按工程结构核对。
- 集成测试连真实服务怎么办?答:独立测试环境,数据可重置,与单元测试分层。
06.8.1.3-070 单元测试与应用测试如何分层?
一句话结论
单元测试覆盖纯逻辑(校验、映射、消息分派),不启动应用;应用测试通过 testApplication 覆盖路由、插件与管道行为;外部契约用集成测试在真实依赖上验证;三层职责分明、执行速度分层。
概念解释
分层依据:依赖边界。纯函数与算法单测快速运行;管道装配与请求链路用应用测试;网络、数据库、消息等真实契约用集成测试。测试金字塔:大量单测、适量应用测试、少量集成测试。
原理流程
- 纯逻辑抽离为可单测函数。
- 应用测试装配模块验证请求链路。
- 少量集成测试验证外部契约。
- 按层选择运行时机(提交前/流水线)。
代码或图示
单元:纯逻辑/映射/校验
应用:路由/管道/插件/认证
集成:真实下游/网络/存储
常见误区
- 全部走应用测试:启动慢且断言绕弯。
- 业务逻辑全在 Handler:无法单测。
追问
- 待确认:项目测试分层约定,按工程文档核对。
- Handler 逻辑怎么便于单测?答:抽到独立服务函数,Handler 只做入参出参编排。
06.8.1.3-071 测试数据清理策略如何设计?
一句话结论
每个用例准备独立数据并在用例结束后清理:内存替身自动重置,数据库用事务回滚或按用例标识删除;不依赖用例执行顺序;并行测试之间数据隔离,公共基线数据在前置一次性准备。
概念解释
数据清理保证可重复执行:残留数据会让用例顺序依赖并产生偶发失败。清理方式按存储选择:内存对象重建、数据库回滚/删除、缓存按命名空间隔离。敏感测试数据不使用真实生产样本。
原理流程
- 用例前置准备独立数据集。
- 执行断言。
- 后置清理或回滚。
- 下一个用例从干净状态开始。
代码或图示
清理层:内存替身重建 / DB 回滚或按标识删除 / 缓存命名空间清空
常见误区
- 用例间靠前一个造的数据:顺序调换即失败。
- 清理只删成功路径数据:异常路径残留。
追问
- 待确认:项目测试数据库与清理约定,按工程文档核对。
- 基线数据放哪里?答:测试前置一次性初始化,不随用例反复增删。
06.8.1.3-072 测试用例如何纳入持续集成执行?
一句话结论
流水线按层执行:提交前跑快速单元与应用测试,流水线跑集成测试;测试报告与覆盖率归档;环境依赖由流水线提供替身或测试环境;失败阻断发布,不跳过已知失败用例。
概念解释
CI 中测试需要确定性:无本机依赖、固定时间与随机值、服务可启停。分层执行控制反馈速度。失败用例修复或标记待确认,不长期注释跳过。测试环境与生产配置分离。
原理流程
- 提交触发快速测试层。
- 流水线执行应用与集成测试。
- 归档报告与覆盖率。
- 失败阻断构建,进入修复流程。
代码或图示
提交:单测 + 应用测试
流水线:集成测试 + 报告归档
发布门禁:测试通过 + 无遗留跳过用例
常见误区
- 测试依赖本地服务/端口:CI 环境起不来。
- 大量用例被注释跳过:质量门禁失效。
追问
- 待确认:项目 CI 脚本与测试任务定义,按工程流水线配置核对。
- 慢测试怎么处理?答:拆分到夜间/集成阶段,先优化测试速度再分层。
06.8.1.3-073 生产引擎选型要考量哪些因素?
一句话结论
按并发模型、阻塞比例、依赖体积、长连接支持、团队排障经验与压测结果选引擎;业务代码保持引擎无关;生产前在目标报文与并发下做基准测试,不凭印象定选型。
概念解释
引擎差异在连接管理、线程模型与协议特性(WS、HTTP/2 支持依实现)。考量维度:吞吐延迟基准、资源占用、成熟度与资料、依赖打包大小。选定后保留切换能力,业务不直引引擎类。
原理流程
- 梳理请求形态:短请求/长连接/阻塞比例。
- 列出候选引擎能力清单。
- 目标负载压测对比。
- 结合依赖与经验定稿。
代码或图示
选型维度:并发模型 / 长连接 / 性能基准 / 依赖体积 / 排障资料 / 团队经验
常见误区
- 只看框架文档推荐:未结合自身负载。
- 业务代码绑定引擎 API:后续无法切换。
追问
- 待确认:Ktor 3 各引擎生产成熟度与 HTTP/2 支持,以官方文档核对。
- 引擎能运行时切换吗?答:装配层换工厂即可,前提是代码未依赖引擎专属行为。
06.8.1.3-074 构建 FatJar 与运行方式如何组织?
一句话结论
服务构建为可执行 Jar(FatJar 包含依赖),由 JVM 直接运行;入口 main 启动引擎;构建产物与源码分离,运行命令固定;版本号、构建信息打入清单便于排障。
概念解释
部署产物是自包含 Jar,目标机器只装 JRE/JDK。启动命令指定 Jar、端口与配置环境变量。分层构建:编译、测试、打包流水线生成可部署制品。不依赖开发机目录结构。
原理流程
- 构建打包含依赖的可执行 Jar。
- 制品存入仓库或镜像层。
- 运行命令启动 main。
- 配置由环境变量/外部配置注入。
代码或图示
构建:编译 -> 测试 -> 打包 FatJar
运行:java -jar app.jar --port=8080
常见误区
- 部署时散拷贝 class 文件:依赖缺失。
- 启动依赖工作目录相对路径:换目录找不到配置。
追问
- 待确认:项目打包脚本与 Jar 命名,按工程构建配置核对。
- JDK 版本基线?答:与项目运行时基线一致,镜像内固定版本。
06.8.1.3-075 Docker 镜像如何打包?
一句话结论
镜像以运行时基础镜像为底,复制可执行 Jar,指定入口命令与暴露端口;分层构建利用缓存,镜像内不存放源码与密钥;非 root 用户运行,镜像版本标签与构建产物对应。
概念解释
容器化打包把 JRE 与应用 Jar 固化进镜像。多阶段构建先编译打包再拷贝运行产物,减小镜像体积。配置与密钥通过环境变量/挂载注入,不写进镜像层。镜像可重复构建,标签可追溯版本。
原理流程
- 构建阶段编译测试打包。
- 运行阶段基础镜像拷贝 Jar。
- 设置入口、端口与非 root 用户。
- 推送镜像仓库并打版本标签。
代码或图示
# 示意:多阶段结构;具体基础镜像版本按项目基线
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 运行降低容器逃逸影响面;写目录(临时文件、日志)通过挂载或临时卷提供。端口号与编排映射关系在部署清单中明确。
原理流程
- 应用监听 0.0.0.0 指定端口。
- 编排层声明容器端口与映射。
- 镜像创建非 root 用户并切换。
- 可写目录挂载到用户可写位置。
代码或图示
容器内:bind 0.0.0.0:8080
编排:containerPort 8080,非 root 用户运行
常见误区
- 绑 127.0.0.1:容器网络外不可达。
- 以 root 跑应用:容器被攻破后权限过高。
追问
- 待确认:项目编排端口与用户配置,按部署清单核对。
- 特权端口(<1024)能在容器用吗?答:非 root 下需端口映射能力,建议用高位端口。
06.8.1.3-077 健康检查与就绪探针如何设计?
一句话结论
存活探针检查进程是否健康(是否需要重启),就绪探针检查是否能接流量(依赖可达、装配完成);两者分开:就绪失败摘流量,存活失败重启;探针接口不认证但限制来源,响应轻量快速。
概念解释
就绪关注「能否服务」:依赖连接、配置加载完成;存活关注「进程是否卡死」。探针端点不应触发重业务逻辑,避免误摘或误重启。慢依赖未就绪时返回未就绪,让编排层摘除实例。
原理流程
- 实现存活检查:进程与基本线程状态。
- 实现就绪检查:依赖可达、初始化完成。
- 编排层配置探针路径与阈值。
- 未就绪摘流量,不健康触发重启。
代码或图示
routing {
get("/health/live") { call.respondText("ok") }
get("/health/ready") { /* 依赖检查 */ }
}
常见误区
- 探针查重依赖:依赖抖动导致频繁重启。
- 存活与就绪混用:该摘流量的实例被直接重启。
追问
- 待确认:项目探针路径与阈值配置,按编排清单核对。
- 启动慢应用怎么处理?答:就绪探针加启动宽限,未完成前不接流量。
06.8.1.3-078 优雅停机在部署中如何配合?
一句话结论
发布/缩容时先摘就绪探针,等待在途请求完成(宽限时限),再停止进程;容器收到停机信号后执行应用停机钩子释放连接池与后台任务;超时后强制终止,保证滚动发布不丢在途请求。
概念解释
优雅停机与编排生命周期配合:信号 -> 停止接收新流量 -> 在途处理 -> 资源释放 -> 退出。宽限时间按接口最长响应设定。长连接(WS)在停机时主动通知客户端重连,而非硬断。
原理流程
- 编排摘除实例流量。
- 应用收到停机信号。
- 等待在途请求至宽限上限。
- 释放资源退出;超时强制终止。
代码或图示
摘流量 -> 在途请求处理 -> 宽限等待 -> 释放资源 -> 退出
常见误区
- 收到信号立即杀进程:在途请求截断。
- 停机钩子不释放客户端/池:实例残留连接。
追问
- 待确认:Ktor 3 停机信号与宽限配置,以引擎文档核对。
- WS 连接停机怎么处理?答:发关闭帧通知客户端重连新实例,宽限内完成迁移。
06.8.1.3-079 环境变量与配置如何注入容器?
一句话结论
配置通过环境变量、挂载配置文件或配置中心注入容器;镜像不含环境差异配置;敏感值走密钥挂载/注入,不写镜像层与仓库;应用启动时读取配置并校验必填项。
概念解释
十二要素式配置与代码分离:同一镜像部署不同环境。配置优先级在启动层合并,缺失必填项启动失败。密钥轮换通过更新注入,不重新构建镜像。配置变更生效方式按设计(重启或热刷新)。
原理流程
- 镜像只含代码与默认值。
- 编排注入环境变量/配置挂载。
- 启动读取合并配置。
- 校验必填后进入服务。
代码或图示
注入方式:环境变量 / 配置挂载 / 配置中心
禁止:密钥写入镜像层、仓库配置文件
常见误区
- 多环境配置打进镜像:镜像不可复用。
- 配置非法仍启动:请求期才暴露问题。
追问
- 待确认:项目配置源与优先级约定,按部署文档核对。
- 配置热更新怎么做?答:显式设计刷新通道,不假设配置自动重载。
06.8.1.3-080 日志输出如何与容器化收集配合?
一句话结论
应用日志输出到标准输出/错误流,由容器日志收集代理采集;不在容器内写持久化日志文件;结构化日志带 trace 标识,级别按环境配置;敏感字段脱敏,日志轮转由收集侧负责。
概念解释
容器文件系统临时且随实例销毁,日志应走标准流由外部采集。结构化输出便于日志平台检索。级别:生产 INFO 或以上,排查时临时调整。日志与审计分开,脱敏规则统一。
原理流程
- 日志框架配置输出 stdout/stderr。
- 结构化字段与 trace 标识。
- 容器代理采集到日志平台。
- 轮转与保留策略在收集侧管理。
代码或图示
应用 -> stdout/stderr -> 节点/代理采集 -> 日志平台
常见误区
- 日志写容器本地文件:实例销毁后丢失。
- 标准输出打印敏感凭据:随日志泄露。
追问
- 待确认:项目日志框架与输出格式约定,按工程配置核对。
- 异常堆栈怎么采集?答:结构化事件携带堆栈字段,由平台检索。
06.8.1.3-081 进程管理与后台运行如何处理?
一句话结论
部署形态由编排/进程管理器负责前台运行与重启策略;应用本身不 fork 后台守护进程;崩溃后由管理器按策略重启,退出码区分正常退出与故障;单实例内后台任务绑定应用生命周期。
概念解释
容器场景应用以前台进程运行,管理器监控退出状态。裸机部署可用 systemd 等进程管理器。应用内后台协程不是系统守护进程,随应用停止。重启策略配合健康检查,避免崩溃循环。
原理流程
- 应用前台启动主进程。
- 进程管理器监控存活与退出码。
- 崩溃按策略重启。
- 应用内后台任务随主进程生命周期管理。
代码或图示
容器:前台 Java 进程 -> 编排重启策略
裸机:进程管理器托管服务进程
常见误区
- 应用内自行 daemon 化:进程管理器失去监控。
- 崩溃循环无退避:持续重启放大故障。
追问
- 待确认:项目部署进程管理方式,按部署文档核对。
- 退出码约定?答:正常退出与异常退出区分,供管理器判定重启策略。
06.8.1.3-082 Kubernetes 部署有哪些注意事项?
一句话结论
部署配置含副本数、资源请求与上限、探针、滚动发布策略与优雅停机;配置与密钥分离注入;无状态服务水平扩缩;环境变量与配置映射按对象注入,避免实例本地状态。
概念解释
K8s 编排管理副本、网络与生命周期。资源配额防止节点过载;探针决定摘流与重启;滚动发布控制新旧版本共存。服务发现与负载均衡由平台提供,应用不写死实例地址。
原理流程
- 配置副本与资源配额。
- 配置存活/就绪探针与停机宽限。
- 滚动发布策略与最大不可用/超量。
- 配置与密钥通过环境/卷注入。
代码或图示
Deployment:replicas / resources / probes / strategy
ConfigMap / Secret:配置与密钥注入
常见误区
- 不设资源上限:实例挤占节点资源。
- 忽略停机宽限:滚动发布截断在途请求。
追问
- 待确认:项目 K8s 清单模板,按部署仓库核对。
- 有状态长连接服务怎么扩缩?答:连接迁移与重连策略配合缩容,WS 实例保存连接状态需特殊设计。
06.8.1.3-083 静态资源在部署中如何处理?
一句话结论
静态资源可打入镜像随服务分发,或由 CDN/对象存储托管;版本化文件名配合长缓存;服务端挂载目录只读;动态接口与静态资源发布流程分离,避免每次发版重传全部资源。
概念解释
静态资源部署选择:随 Jar/镜像分发适合小规模;CDN 托管适合大流量前端。资源路径带内容哈希,发版更新索引引用。容器内资源目录只读,上传类可写目录单独挂载。
原理流程
- 构建产物含版本化静态资源。
- 镜像分发或上传 CDN/存储。
- 服务挂载只读资源目录。
- 索引页面引用新版本哈希资源。
代码或图示
方案 A:资源打入镜像随服务发布
方案 B:资源上 CDN/对象存储,服务只发索引
常见误区
- 未版本化资源长缓存:发版后客户端旧文件。
- 静态资源目录可写:容器逃逸与篡改风险。
追问
- 待确认:项目前端资源与服务端资源分发方式,按工程结构核对。
- 缓存失效怎么处理?答:版本化文件名 + 索引不缓存。
06.8.1.3-084 多实例部署与无状态约束是什么?
一句话结论
多实例下应用不保存请求级与会话级本地状态;共享状态外置到数据库/缓存/对象存储;实例可随时重启与扩缩;本地缓存仅作可重建的只读优化,会话与计数走共享存储。
概念解释
水平扩缩前提:任意实例可处理任意请求。本地内存会话、限流计数、上传文件在多实例下不一致。会话粘滞只是过渡方案,不消除状态外置需求。无状态设计让发布与扩容简单可控。
原理流程
- 识别本地状态清单。
- 会话/计数/文件外置共享存储。
- 本地缓存可失效重建。
- 实例无状态化后副本自由调度。
代码或图示
实例无状态 + 共享 DB/Redis/对象存储
本地:仅只读可重建缓存
常见误区
- 用会话粘滞代替状态外置:实例重启仍丢状态。
- 本地限流计数:多实例配额成倍放大。
追问
- 待确认:项目共享存储组件清单,按架构文档核对。
- 长连接状态怎么多实例共享?答:连接留在节点,跨节点路由经中间件,见 WS 推送题目。
06.8.1.3-085 启动失败与端口占用如何排查?
一句话结论
启动失败先看异常堆栈:端口占用、配置缺失、依赖连接失败、类加载冲突;端口占用查监听进程与残留实例;容器内区分绑定地址与端口映射;配置类错误在启动日志定位缺失键。
概念解释
启动阶段失败类型:网络绑定、配置校验、外部依赖连接、构建/类冲突。排查顺序:读堆栈 -> 定位类别 -> 核对环境与配置 -> 检查残留进程。不要反复重启不查根因。
原理流程
- 读取启动异常与错误信息。
- 区分绑定/配置/依赖/类加载问题。
- 检查端口监听与残留实例。
- 核对配置源与依赖连通性。
代码或图示
排查链:堆栈 -> 端口占用 -> 配置缺失 -> 依赖连通 -> 类/版本冲突
常见误区
- 只看最终退出码:根因在早期日志。
- 容器端口与宿主机映射混淆:进程内正确但外部不通。
追问
- 待确认:各引擎绑定失败异常类型,以引擎实现核对。
- 依赖连不上怎么区分?答:启动日志的连接异常与超时记录,核对网络与凭据配置。
06.8.1.3-086 资源配额:内存、线程与连接数如何估算?
一句话结论
内存按堆外+堆内占用与报文大小估算并设上限;线程数按阻塞比例与并发模型调优;连接数(下游连接池、入站连接)按下游容量与实例数分配;配额以压测拐点为依据,不照搬公式。
概念解释
资源配额互相影响:内存不足触发 GC 或 OOM,线程过多增加切换,连接数受下游限制。估算输入:并发量、单请求内存、阻塞比例、下游连接上限。压测验证拐点后设定请求与限制。
原理流程
- 压测测得单请求内存与线程占用。
- 按目标并发估算堆与线程需求。
- 下游连接池按下游容量分摊到实例。
- 设资源上限与过载保护。
代码或图示
内存:堆内对象 + 报文缓冲 + 堆外
线程:并发模型 × 阻塞比例
连接:下游总容量 / 实例数
常见误区
- 线程数设成等于并发连接数:协程模型下不必要。
- 不设内存上限:单个大报文拖垮容器。
追问
- 待确认:项目资源基线与压测数据,按部署记录核对。
- 过载保护怎么做?答:队列上限 + 快速拒绝 + 降级,避免资源耗尽雪崩。
06.8.1.3-087 部署版本回滚与健康基线如何管理?
一句话结论
发布前建立健康基线(指标、探针、错误率),新版本灰度观察指标偏离后再全量;回滚到上一稳定制品,配置兼容回滚;数据库变更向后兼容,避免回滚被旧版本卡住。
概念解释
回滚能力依赖制品可追溯与配置兼容。健康基线对照:延迟、错误率、探针状态、下游调用成功率。灰度阶段异常自动或手动回退。回滚演练纳入发布流程,不等到故障时尝试。
原理流程
- 记录上一稳定制品与配置。
- 灰度发布对比健康基线。
- 异常触发回滚到稳定版本。
- 数据库变更保持向后兼容。
代码或图示
基线指标:延迟分位 / 错误率 / 探针 / 下游成功率
回滚:稳定制品 + 兼容配置 + 向后兼容 DB 变更
常见误区
- 数据库变更不兼容回滚:旧版本无法启动。
- 不建基线:新版本是否退化无法判断。
追问
- 待确认:项目发布与回滚流程,按部署文档核对。
- 配置变更能单独回滚吗?答:按配置版本管理,与制品回滚分别处理。
06.8.1.3-088 部署脚本与基线配置有哪些待核对点?
一句话结论
核对:打包脚本入口、运行时版本、端口与配置注入方式、探针路径、停机宽限、资源配额与镜像基础版本;未核实的命令与参数标「待确认」,以项目构建部署文件为准,不编造脚本内容。
概念解释
部署基线包括构建命令、运行命令、环境变量清单、健康检查与资源限制。核对路径:项目构建脚本、编排清单、部署文档。脚本应自定位目录、不写死本机路径,可在任意环境重复执行。
原理流程
- 收集项目构建与部署配置。
- 逐项核对版本、端口、探针、资源。
- 标注与官方文档不一致的待确认点。
- 变更后在测试环境验证部署流程。
代码或图示
核对清单:构建命令 / 运行时版本 / 配置注入 / 探针 / 停机宽限 / 资源配额 / 基础镜像
常见误区
- 凭通用模板写项目专属部署参数:与实际清单不符。
- 脚本写死本机目录路径:跨环境不可用。
追问
- 待确认:本项目实际构建脚本与部署清单,以仓库内脚本/编排文件为准。
- 跨平台脚本约定?答:按项目 .gitattributes 与脚本规范维护换行与入口。
06.8.1.3-089 场景:长连接服务如何做容量规划?
一句话结论
按单连接内存占用、消息速率与心跳开销估算可承载连接数;连接数配额分实例与全局;消息推送带宽与队列深度纳入规划;连接限流与降级预案配套,扩缩容基于连接数与消息积压指标。
概念解释
长连接资源模型不同于短请求:连接常驻占用内存与文件描述符,消息突发占用队列与带宽。规划输入:单连接缓冲、在线峰值、消息频率、心跳流量。单实例连接上限在引擎与系统层面都要核对。
原理流程
- 压测单连接内存与 FD 占用。
- 估算峰值连接数与实例数。
- 评估消息突发队列与带宽。
- 配置连接限流与扩容指标。
代码或图示
容量:连接数 × 单连接内存/FD + 消息速率 × 队列/带宽
常见误区
- 按短请求线程模型估算长连接:资源占用误判。
- 不限制连接数:恶意连接打满实例资源。
追问
- 待确认:引擎与系统文件描述符上限配置,按部署环境核对。
- 连接迁移怎么做?答:缩容时通知重连,新实例承接,状态经共享存储恢复。
06.8.1.3-090 场景:第三方调用超时如何不拖垮主流程?
一句话结论
下游调用设独立超时与隔离池,失败快速降级;并发度受控,重试有限;主流程不被慢下游阻塞,超时返回兜底结果或部分数据;下游异常指标告警,熔断防止持续冲击。
概念解释
慢下游拖垮主流程的路径:线程/连接被等待占满 -> 新请求排队 -> 整体雪崩。隔离手段:超时、舱壁池、熔断、降级。关键依赖与次要依赖分别配置策略,次要失败不阻断主功能。
原理流程
- 识别下游依赖与重要级别。
- 配置超时、隔离池与并发上限。
- 超时/熔断走降级响应。
- 监控下游延迟与失败率告警。
代码或图示
withTimeoutOrNull(1_500) { remote.fetch() } ?: fallback()
常见误区
- 所有下游共用无界线程池:一个慢依赖拖累全部。
- 重试叠加超时:下游故障时压力放大。
追问
- 待确认:项目熔断/舱壁组件选型,按实际依赖核对。
- 降级数据从哪来?答:缓存、默认值或部分聚合,按业务可接受度设计。
06.8.1.3-091 场景:接口测试应覆盖哪些关键路径?
一句话结论
覆盖:正常成功、参数校验失败、未认证/无权限、下游失败降级、并发与边界值;核心业务链路端到端走通;异常状态码与错误结构断言;测试数据与替身隔离,关键路径纳入 CI 门禁。
概念解释
测试路径按风险排序:主流程先覆盖,错误分支与安全路径补齐。边界值(分页上下限、空集合、大报文)与并发场景单独验证。每个对外接口至少有成功与一类失败用例。
原理流程
- 列出接口清单与依赖。
- 标注核心链路与安全路径。
- 编写成功/失败/边界用例。
- 纳入 CI 并定期补全覆盖缺口。
代码或图示
覆盖矩阵:成功 / 校验失败 / 认证授权 / 下游异常 / 边界值 / 并发
常见误区
- 只覆盖 happy path:错误与安全分支裸奔。
- 测试断言只看状态码:响应内容未验证。
追问
- 待确认:项目测试覆盖度要求,按工程质量约定核对。
- 遗留未覆盖接口怎么跟踪?答:列入待整理清单,随业务迭代补齐。
06.8.1.3-092 场景:容器发布如何做到不停机?
一句话结论
滚动发布:新实例就绪后摘旧实例流量,旧实例等待在途请求完成再停机;就绪探针控制接入时机,优雅停机宽限覆盖最长请求;版本与配置向后兼容,新旧版本短暂共存期间接口契约一致。
概念解释
不停机依赖:就绪探针、优雅停机、负载均衡摘除与兼容契约。灰度先起新版本接少量流量,再逐步替换旧版本。数据库与配置变更兼容旧版本运行。WS 等长连接在旧实例下线时引导重连。
原理流程
- 启动新实例,就绪通过后接入。
- 流量逐步切到新版本。
- 旧实例摘流量并等待在途完成。
- 旧实例释放资源退出。
代码或图示
新实例就绪 -> 流量切换 -> 旧实例摘流 -> 在途完成 -> 旧实例退出
常见误区
- 旧实例收到信号立即终止:在途请求截断。
- 接口契约不兼容:共存版本互相调用失败。
追问
- 待确认:项目滚动发布策略与 maxUnavailable 配置,按编排清单核对。
- 长连接发布怎么平滑?答:通知客户端重连,旧实例宽限内逐步断开。
06.8.1.3-093 客户端连接池满了如何排查?
一句话结论
池满表现为请求等待连接或超时:先看池占用与等待队列,确认响应是否消费归还、并发是否超配、下游连接是否被对端关闭;区分泄漏(未消费)与容量不足(并发过高)。
概念解释
连接池耗尽两类原因:连接未归还(泄漏)或需求超过池容量。排查指标:空闲连接、等待线程、新建连接速率、下游关闭现象。代码走查响应消费与异常分支,容量按压测调整。
原理流程
- 采集池占用、等待队列与连接生命周期。
- 检查响应体是否全部消费。
- 核对并发度与池上限、下游容量。
- 修复泄漏或调整池/并发配额。
代码或图示
排查:池空闲数 / 等待队列 / 响应消费路径 / 下游断连 / 并发上限
常见误区
- 直接调大池上限:泄漏被掩盖,下游被压垮。
- 忽略异常分支未读 body:连接持续滞留。
追问
- 待确认:所用引擎连接池指标暴露方式,以引擎文档核对。
- 池满时新请求怎么处理?答:快速失败降级,不无限排队等待。
06.8.1.3-094 WebSocket 连接数过高如何限流?
一句话结论
按主体(用户/租户/IP)与全局上限限制连接数:握手阶段计数,超限拒绝升级;连接结束释放计数;配合心跳清理死连接;多实例全局限额经共享存储统计,防单实例绕过。
概念解释
连接限流保护内存与文件描述符。维度:单用户多设备上限、单 IP 上限、全局连接上限。计数在握手成功时增加,会话结束减少;崩溃连接由心跳/超时清理后释放额度。
原理流程
- 握手前检查主体连接计数。
- 超阈值拒绝握手。
- 成功建立计入额度。
- 结束/超时后释放计数。
代码或图示
限流维度:全局 / 每用户 / 每 IP
计数:握手 +1,会话结束 -1,死连接超时回收
常见误区
- 只限制消息频率不限制连接数:连接本身占资源。
- 崩溃连接计数不释放:额度被幽灵连接耗尽。
追问
- 待确认:项目连接限额策略,按容量规划核对。
- 多实例计数怎么一致?答:共享存储统计,允许短暂误差按业务容忍度设定。
06.8.1.3-095 响应体过大导致内存问题如何处理?
一句话结论
大响应改为流式分块写出,不在内存聚合成全量对象;限制单响应大小;大列表分页或游标加载;监控响应大小分布与堆内存峰值,区分报文过大与对象模型冗余。
概念解释
内存爆点:全量集合进堆、报文缓冲未释放、序列化大对象。处理方向:分批/流式、分页查询、DTO 精简。上传与下载分别控制大小。压测用最大报文验证内存峰值。
原理流程
- 定位大响应来源:列表规模/字段冗余/文件下载。
- 改流式或分页加载。
- 限制单响应与单字段大小。
- 压测验证堆峰值与 GC 表现。
代码或图示
优化:分页/游标 -> 流式写出 -> DTO 精简 -> 大小上限
常见误区
- 一次性查全表再序列化:堆峰值随数据量线性增长。
- 响应 DTO 携带多余实体字段:序列化体积放大。
追问
- 待确认:项目列表接口分页基线,按 API 约定核对。
- 流式响应与缓存/压缩如何配合?答:按响应类型排除不兼容插件,见压缩题目。
06.8.1.3-096 部署后探针失败常见原因有哪些?
一句话结论
探针失败常见于:依赖未就绪、端口绑定地址错误、探针路径未注册、启动配置缺失、资源不足导致进程卡死;区分存活失败与就绪失败,按日志与事件定位,不要盲目重启反复触发。
概念解释
就绪失败多为依赖连接、初始化未完成;存活失败多为进程死锁、OOM、卡死。排查看应用启动日志、依赖连通性、探针路由与资源事件。探针自身实现过重也会误判。
原理流程
- 区分存活/就绪失败类型。
- 读应用日志定位启动阶段。
- 核对依赖连通与配置。
- 检查探针路由、绑定地址与资源事件。
代码或图示
就绪失败:依赖 / 初始化 / 配置
存活失败:死锁 / OOM / 进程卡死
常见误区
- 探针查重依赖:依赖抖动误判未就绪。
- 探针路径未注册:一直 404 被判定失败。
追问
- 待确认:项目探针实现与编排阈值,按部署清单核对。
- 启动慢被反复重启怎么办?答:配置启动宽限,就绪探针延迟开始检查。
06.8.1.3-097 服务端与客户端版本兼容注意什么?
一句话结论
接口契约向后兼容:字段新增可选、旧字段不随意改类型/删除;序列化配置两端一致;版本通过路径、头或契约标识区分;废弃字段过渡期保留,客户端按容错策略解析未知字段。
概念解释
兼容问题出现在滚动发布期间:新旧客户端与服务端短暂共存。字段约定:新增可选、删除先废弃、类型不变。枚举与日期格式两端对齐。破坏性变更走独立版本接口,不原地改契约。
原理流程
- 契约变更评估向后兼容。
- 新增字段可选,解析忽略未知键。
- 破坏性变更新版本号。
- 过渡期观察旧版本调用量后下线。
代码或图示
兼容策略:可选新增 / 废弃保留 / 类型不变 / 破坏性变更独立版本
常见误区
- 服务端收紧未知字段:旧客户端新字段被拒。
- 枚举新增值旧客户端不识别:分支遗漏报错。
追问
- 待确认:项目接口版本约定,按 API 文档核对。
- WS 协议版本怎么兼容?答:握手子协议标识版本,消息信封带版本字段。
06.8.1.3-098 压测指标与容量拐点怎么看?
一句话结论
压测看吞吐、延迟分位、错误率、资源利用率与下游依赖;拐点是吞吐不再上升或延迟骤升、资源打满的位置;容量按拐点留余量设定,过载保护在拐点之前触发。
概念解释
单看平均值会掩盖长尾。分位延迟反映用户体验,资源利用率定位瓶颈(CPU/内存/连接/下游)。逐级加压找到拐点,区分自身瓶颈与下游瓶颈。容量目标负载低于拐点并留余量。
原理流程
- 按典型报文逐级加压。
- 采集吞吐、P95/P99、错误率、资源指标。
- 定位瓶颈资源与拐点。
- 设定生产容量与过载阈值。
代码或图示
拐点特征:吞吐停滞 / 延迟骤升 / CPU 或连接池打满 / 错误率上升
常见误区
- 以最高吞吐定容量:长尾延迟已不可接受。
- 压测不隔离下游:瓶颈定位错误。
追问
- 待确认:项目压测环境与基线数据,按性能记录核对。
- 容量余量留多少?答:按业务峰值增长与突发系数设定,不贴拐点运行。
06.8.1.3-099 常见生产事故复盘应覆盖哪些清单?
一句话结论
复盘覆盖:现象与影响范围、触发条件、时间线、根因(代码/配置/容量/依赖)、检测与告警是否及时、恢复动作与遗留改进项;形成可追踪的改进任务,不只归因为「流量大」。
概念解释
事故清单:监控缺失、配置漏配、容量不足、依赖故障、发布缺陷、安全问题。复盘区分直接原因与流程原因:测试覆盖、发布门禁、预案演练。改进项有负责人与期限,回归验证。
原理流程
- 还原时间线与影响面。
- 定位根因与触发条件。
- 评估检测、告警、恢复各环节缺口。
- 输出改进任务并跟踪闭环。
代码或图示
复盘清单:现象 / 时间线 / 根因 / 检测告警 / 恢复动作 / 改进项 / 回归验证
常见误区
- 复盘只写操作总结:根因与改进未落地。
- 同类问题重复发生:改进项未跟踪闭环。
追问
- 待确认:项目事故记录模板,按团队流程核对。
- 预案演练怎么做?答:定期演练故障切换、降级与回滚,验证预案可执行。
06.8.1.3-100 Ktor 客户端与服务端一体有哪些适用场景?
一句话结论
同一套协程模型、序列化配置与 DTO 在服务端与客户端复用,适合内部服务间调用、工具型应用、多端 SDK 与轻量网关;重企业生态集成或既有容器体系下,按团队与依赖成熟度评估。
概念解释
一体优势:跨端代码与契约复用、协程语义一致、插件思路同构。限制:客户端引擎与服务端引擎生态不完全对等,小众集成仍需自研。选型结合团队 Kotlin/协程经验与长期维护成本。
原理流程
- 识别可复用的 DTO、序列化与客户端配置。
- 评估服务间调用场景与生态依赖。
- 概念验证关键链路。
- 按维护成本定稿框架边界。
代码或图示
适合:内部服务调用 / 工具应用 / 多端 SDK / 轻量协程网关
评估:企业集成需求 / 团队经验 / 生态成熟度
常见误区
- 为复用而硬上一体:两端需求差异被忽视。
- 假设客户端服务端插件完全通用:集合与配置有差异。
追问
- 待确认:Ktor 3 客户端/服务端组件成熟度,以官方文档与生态核对。
- 与既有 HTTP 客户端并存可行吗?答:可按服务域选择,不必全量替换。
参考来源
- Ktor 客户端文档:HttpClient 引擎、插件、超时、序列化与异常处理。
- Ktor WebSocket 文档:服务端与客户端 WS 会话、帧、心跳与生命周期。
- Ktor 测试文档:testApplication、测试客户端与 MockEngine。
- Ktor 引擎与部署文档:服务端引擎选型与运行部署说明。
- Kotlin 协程文档:结构化并发、调度器与取消模型基础。
待整理清单
- [ ] 核对 Ktor 3 客户端引擎清单、连接池与超时配置项名称
- [ ] 核对 WS 服务端/客户端注册 DSL、会话收发 API、帧类型与心跳配置
- [ ] 核对 SSE 支持方式(原生插件或流式响应)与 Last-Event-ID 处理
- [ ] 核对 testApplication、测试客户端与 MockEngine 的 API 签名
- [ ] 核对项目打包脚本、运行时版本、探针路径与资源配额基线
- [ ] 补充实际工程中的客户端隔离、WS 连接管理与部署编排示例