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

06.7.1.2 提取器、中间件与错误处理

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.7 Rust 后端 / 06.7.1 Rust 后端工程

本节要解决的问题

  • 提取器如何取值与失败响应,自定义提取器怎么写?
  • tower 中间件层如何叠加,顺序与短路如何控制?
  • Rust 错误如何用 thiserror/anyhow 统一建模并映射 HTTP 响应?

版本前提:Rust 1.7x + Axum 0.7 / tower;提取器与错误 trait 细节以官方文档为准,版本敏感项标「待确认」。

06.7.1.2-001 Extractor 机制与失败处理是什么?

一句话结论

提取器从请求构造 Handler 参数,实现对应 trait 完成反序列化与校验;提取失败返回实现 IntoResponse 的错误响应;不同提取器有只读与消耗 body 的语义区分。

概念解释

提取器把"从请求取数"的逻辑泛型化:路径、查询、JSON、头、State 各有实现。失败时不进入 Handler,直接由错误响应收口。

常见误区

  • 提取失败 panic:应返回结构化错误响应,不依赖 unwrap。
  • 多个提取器重复消费 body:body 只能被取一次,顺序需符合框架约束。

追问

  • 提取器错误如何转 JSON?错误类型实现 IntoResponse,统一错误结构。
  • 提取器能访问 State 吗?可在自定义提取器中读取 State 部件(以 Axum 文档为准)。

06.7.1.2-002 如何自定义提取器?

一句话结论

为自定义类型实现提取器 trait,从请求部件取值、校验并构造类型;失败返回错误响应;复用框架的错误映射;通用解析逻辑封装在提取器,Handler 只接收类型化结果。

概念解释

自定义提取器适合把认证主体、租户上下文、签名参数等从请求中结构化取出。实现 trait 后即可像内置提取器一样作为 Handler 参数。

常见误区

  • 在每个 Handler 重复手写取头与解析:应抽成提取器统一处理。
  • 提取器内做重业务逻辑:提取器只负责取值与基础校验,规则放 Service。

追问

  • 路径/查询提取与自定义提取能否组合?可以,参数分别声明,类型各自提取。
  • 提取器里能异步读外部数据吗?可以,但注意失败响应与超时控制。

06.7.1.2-003 tower 中间件 Layer 如何工作?

一句话结论

Layer 包装内层 Service,中间件逻辑在调用前后插入;请求按层顺序穿过,响应原路返回;日志、超时、限流、鉴权以 Layer 叠加;层顺序即包裹顺序。

概念解释

tower 把中间件抽象为 Service 装饰器:每层拿到内层 Service 调用。外层先看到请求,后看到响应;组合顺序影响观测与拦截位置。

常见误区

  • 中间件顺序挂反:鉴权在限流之后或日志位置错误,影响保护与观测。
  • 自写层不保留错误传播:内层错误被吞掉,状态码丢失。

追问

  • 中间件怎么挂到 Axum?Router::layer 或路由级应用(以 Axum 文档为准)。
  • 全局与局部层怎么分?观测/恢复全局挂,鉴权/限流按模块挂。

06.7.1.2-004 统一错误处理如何设计?

一句话结论

定义领域错误枚举,用 thiserror 派生错误类型,anyhow 用于应用上下文;错误实现 IntoResponse 映射 HTTP 状态与统一 JSON;内部细节进日志,对外只给业务码与可读消息;用 ? 传播,避免 unwrap。

概念解释

错误分层:领域错误携带类型与消息,底层错误经包装保留链;响应映射集中在 IntoResponse 实现。thiserror 适合可枚举的库/领域错误,anyhow 适合应用层任意错误上下文。

示例

#[derive(Debug, thiserror::Error)]
pub enum AppError {
    #[error("not found: {0}")]
    NotFound(String),
    #[error(transparent)]
    Internal(#[from] anyhow::Error),
}

常见误区

  • 用 unwrap/expect 处理可能失败的取值:触发 panic,破坏请求稳定性。
  • 把内部错误消息原样返回客户端:泄漏 SQL、路径与依赖细节。
  • 错误链被丢弃:包装时不保留 source,排查丢失根因。

追问

  • thiserror 与 anyhow 分工?thiserror 定义具体错误枚举,anyhow 兜住应用内任意错误,trait 对象上下文。
  • 错误如何映射 4xx/5xx?枚举变体对应状态码,见 06.7.1.2-005。

06.7.1.2-005 错误到 HTTP 状态如何映射?

一句话结论

每个错误变体在 IntoResponse 实现中映射状态码:参数非法 400、未认证 401、无权限 403、不存在 404、冲突 409、内部/下游异常 5xx;未识别错误归 500 且不暴露细节。

概念解释

错误类型携带语义,响应层翻译为 HTTP 大类与业务码。映射规则集中在一处,避免各 Handler 手写状态判断。

常见误区

  • 所有错误返回 500:客户端错误被误判为服务故障,监控失真。
  • 401/403 混用:未登录与无权限语义不同,前端处理分支错误。

追问

  • 下游调用失败映射什么?按场景 502/503,业务码标记下游异常并告警。
  • 响应体结构?统一码、消息、字段级错误详情,成功与失败同一 envelope。

06.7.1.2-006 错误链如何保留与记录?

一句话结论

用 #[source] 或 ?/transparent 保留底层错误来源;日志沿链打印 source();对外响应不展开链;包装错误时附上上下文(操作、对象标识)。

概念解释

错误链从领域错误回溯到底层驱动错误。保留 source 便于定位根因,日志输出链上各层消息与类型;响应只暴露领域层可读信息。

常见误区

  • map_err 丢弃原错误:只剩一条笼统消息,排查断链。
  • 日志只打最外层:看不到底层是连接超时还是约束冲突。

追问

  • anyhow::Error 怎么取链?source() 逐层回溯(以 anyhow 文档为准)。
  • 跨边界错误怎么转?进入领域层时包装为领域错误,保留底层 source。

06.7.1.2-007 为什么生产代码应避免 unwrap?

一句话结论

unwrap/expect 在值为 None/Err 时直接 panic;异步请求 panic 可能中断任务甚至影响进程;生产路径应显式处理错误并返回响应;测试与初始化常量场景才可使用。

概念解释

Rust 用类型系统强制显式处理可空与错误。unwrap 是放弃检查的捷径,只在编译期可证明安全或测试代码中合理使用。

常见误区

  • 解析配置/请求字段时 unwrap:非法输入直接 panic 而非 400 响应。
  • 把 unwrap 当"临时写法"留到生产:异常输入触发崩溃。

追问

  • 替代写法?ok_or/ok_or_else 转错误,? 传播,match/if let 分支处理。
  • panic 在 Axum 中如何表现?框架有恢复处理机制,具体行为以 Axum 版本为准(待确认),不应依赖其兜底。

06.7.1.2-008 tracing 日志中间件怎么接入?

一句话结论

用 tower/tracing 中间件为每个请求建立 span,携带 traceID、方法、路径;Handler 与 Service 在 span 内记录事件;日志结构化输出,span 贯穿一次请求的异步调用链。

概念解释

tracing 用 span 表示操作上下文,事件挂在 span 下。中间件入口创建 span,跨异步任务传播上下文,日志按 span 聚合一次调用。

常见误区

  • 异步任务丢失 span:跨 spawn 需显式传播上下文,否则日志断链。
  • span 内记录敏感请求体:应脱敏,避免信息泄漏。

追问

  • traceID 怎么生成/透传?入口生成或读取上游头,放入 span 与响应头。
  • tracing 与日志库关系?tracing 负责结构化事件与 span,订阅层输出到日志系统。

06.7.1.2-009 异步超时与取消如何传递?

一句话结论

在异步链上用超时包装器限制下游等待;请求取消时任务跟随退出;Context/取消令牌贯穿异步调用;阻塞隔离任务也要能被取消;超时后清理连接与事务。

概念解释

异步生态靠超时与取消避免任务悬挂。运行时在请求结束时取消任务,代码应监听取消信号并释放资源。

常见误区

  • 异步下游调用不加超时:慢下游拖住任务与连接。
  • 取消后不清理:连接、事务、后台任务悬挂占用资源。

追问

  • 超时组件用什么?Tokio timeout 或 tower timeout 层(以文档为准)。
  • 取消与错误处理区别?取消是生命周期事件,错误是操作失败,日志与响应分别处理。

06.7.1.2-010 提取器失败的状态码如何约定?

一句话结论

JSON 反序列化失败、缺字段、类型不匹配返回 400;路径/查询非法归入参数错误;认证相关提取失败返回 401;提取器错误响应结构与业务错误一致;字段级提示可定位输入项。

概念解释

提取失败发生在进入 Handler 前,框架按错误类型映射状态。约定统一后前端可按码处理输入问题,而不是把所有提取失败当 500。

常见误区

  • 提取失败默认 500:客户端输入问题被误报为服务故障。
  • 响应不指明字段:前端无法定位哪个参数非法。

追问

  • 枚举值非法怎么响应?反序列化失败转 400,消息说明合法取值范围。
  • 与 Service 层校验失败区别?提取器管格式与反序列化,Service 管业务一致性。

06.7.1.2-011 中间件短路与放行如何控制?

一句话结论

中间件可在鉴权/限流失败时直接返回错误响应,不调用内层 Service;通过则放行到下游;日志等后置逻辑在响应返回后执行;短路后不再进入 Handler。

概念解释

tower 层决定是否调用内层 Service。拦截型中间件(鉴权、限流)失败即短路,观测型中间件总要看到最终响应。

常见误区

  • 短路后仍调用内层:鉴权失败请求继续执行,造成越权。
  • 后置逻辑在放行前写死:拿不到下游状态码与耗时。

追问

  • 短路响应怎么写?构造 Response 直接返回,不进入内层。
  • 中间件能改请求/响应吗?可以,请求部件可注入,响应可在返回前加工。

06.7.1.2-012 请求校验如何与 serde 配合?

一句话结论

DTO 用 serde 反序列化,字段用类型与属性表达必填/可选;格式与范围校验在提取后或自定义提取器完成;跨字段规则在 Service 层;校验错误转为字段级响应。

概念解释

serde 解决反序列化与类型映射,不承担业务规则校验。DTO 结构即接口契约,与领域模型分离。

常见误区

  • 把领域模型直接当反序列化 DTO:传输字段泄漏到业务层。
  • 依赖 serde 校验取值范围:范围/唯一/关联一致性需业务代码判定。

追问

  • 可选字段怎么表达?Option<T>,缺失与显式 null 按 serde 规则处理(待确认版本行为)。
  • 校验库怎么选?生态校验 crate 可配合 DTO,以维护状态为准。

06.7.1.2-013 响应包装与 JSON 序列化如何统一?

一句话结论

定义成功/失败响应结构体,统一字段(码、消息、数据、错误详情);Handler 返回包装类型;JSON 序列化通过 Json<T>;序列化失败归入内部错误;不在各 Handler 手写重复结构。

概念解释

响应契约在传输层固化,前端解析规则一致。包装函数/类型集中处理字段,业务只返回数据或错误。

常见误区

  • 成功返回裸对象、失败返回错误结构:前端两套解析分支。
  • 序列化内部领域对象:字段与数据库结构直接暴露。

追问

  • 分页响应怎么组织?统一列表包 items、分页元信息字段。
  • 枚举序列化格式?按约定序列化为字符串或数值,前后端一致。

06.7.1.2-014 错误上下文与 span 如何配合?

一句话结论

错误在 span 内记录,携带 span 上下文(traceID);错误事件记录级别与关键字段;响应回传 traceID 供排查;异步任务内错误也要归属到请求 span。

概念解释

日志靠 span 关联请求,错误是请求链上的事件。跨任务传播 span 上下文,避免错误日志脱离请求上下文。

常见误区

  • 后台任务错误不挂 span:无法关联到触发请求。
  • 错误日志重复打印多层:沿链记录一次根因与包装上下文即可。

追问

  • 跨 spawn 怎么传 span?克隆 span 上下文传入任务(以 tracing 文档为准)。
  • 错误级别怎么定?可预期业务警告,内部错误 error,下游异常按影响定级。

06.7.1.2-015 Actix 错误处理与 Axum 有何对应?

一句话结论

两者都要求错误类型转换为响应;Actix 有自身错误 trait 与响应转换体系,Axum 用 IntoResponse;错误建模思路(领域枚举、状态映射、内部细节隔离)通用,API 实现不同。

概念解释

框架无关的是错误分层与响应契约,框架相关的是 trait 名与转换机制。业务错误类型可保持框架无关,适配层实现转换。

常见误区

  • 复制 Axum 错误 trait 到 Actix:接口签名与错误类型不同。
  • 错误类型绑死框架:领域层应定义自身错误,Web 层适配。

追问

  • Actix 错误 trait 是什么?以 Actix-web 官方文档为准(待确认)。
  • 跨框架迁移错误处理?领域错误不变,重写响应适配层。

06.7.1.2-016 panic 如何捕获与恢复?

一句话结论

入口层依赖框架恢复机制兜底 panic;业务路径用错误返回而非 panic;异步 spawn 的任务自行处理失败;panic 堆栈只进日志;恢复后按 500 统一响应,不能假设响应可正常改写。

概念解释

panic 是不可恢复的编程错误信号,错误处理体系用 Result 表达可预期失败。框架恢复防止单请求 panic 拖垮进程,但不能替代显式错误处理。

常见误区

  • 把可预期错误用 panic 抛出:应返回 Result 错误变体。
  • 异步任务内 panic 不处理:可能导致任务终止,上层无错误感知。

追问

  • Axum 恢复行为?以版本文档为准(待确认),不在代码中依赖其细节。
  • 初始化阶段 panic 合理吗?配置缺失等启动错误可退出进程,运行期请求不应 panic。

06.7.1.2-017 输入校验失败响应结构怎么设计?

一句话结论

响应含错误码、可读消息与字段详情数组(字段名 + 消息);HTTP 400;字段名与 DTO 字段对应;不暴露内部校验规则细节;批量字段错误一次返回。

概念解释

字段级详情让前端定位输入项。结构与其他业务错误复用同一 envelope,只在数据段放校验详情。

常见误区

  • 只返回第一条错误:前端需多次提交才能改完全部问题。
  • 字段名用内部变量名:与接口字段不一致,前端无法绑定。

追问

  • 跨字段错误字段名留空?用约定的特殊键,消息说明冲突规则。
  • 校验错误记日志吗?记摘要与 traceID,不重复记录敏感输入。

06.7.1.2-018 领域错误与传输错误如何分层?

一句话结论

领域层定义业务错误(不存在、冲突、无权限),不依赖 Web 框架;传输层把领域错误映射为 HTTP 响应;底层驱动错误在仓储层包装为领域错误;两层错误类型不互相泄漏。

概念解释

分层让业务规则可脱离 Web 测试:Service 返回领域错误,Handler 适配传输。框架更换时领域错误模型不变。

常见误区

  • Service 返回 StatusCode 或 JSON 结构:业务层绑定传输层。
  • 数据库错误直接透传到响应:底层细节泄漏,语义也不匹配。

追问

  • 错误转换在哪一层?Repository 转领域错误,Handler/中间件转 HTTP。
  • 领域错误怎么单测?断言错误变体,不依赖 HTTP 响应。