06.6.1.2 中间件、错误处理与上下文取消
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.6 Go 后端 / 06.6.1 Go 后端工程
本节要解决的问题
- 中间件链如何组织,
Next/Abort语义是什么? - Go 错误如何分层、映射 HTTP 状态与统一响应?
context.Context如何做超时、取消与并发治理?
版本前提:Go 1.22+;context、errgroup 行为以标准库文档为准。
06.6.1.2-001 Gin 中间件链怎么执行?
一句话结论
中间件在 Handler 之前按挂载顺序包裹执行,c.Next() 放行到下游,c.Abort() 阻止后续中间件与 Handler;Next 之前的逻辑在请求进入时执行,之后的逻辑在响应返回时执行。
概念解释
中间件是切面:记录日志、鉴权、超时、恢复等通用逻辑横切在 Handler 外。链顺序即包裹顺序,先挂载的最外层。
示例
func Logger() gin.HandlerFunc {
return func(c *gin.Context) {
start := time.Now()
c.Next() // 放行下游
// 响应返回后执行
log.Printf("%s %s %v", c.Request.Method, c.Request.URL.Path, time.Since(start))
}
}
常见误区
- 把所有逻辑写在
Next之前:后置动作(耗时、状态码记录)拿不到下游结果。 - 鉴权失败后不
Abort:Handler 仍会执行,造成越权访问。
追问
- 全局与分组中间件顺序?全局先执行,再组中间件,最后 Handler。
- 中间件能改响应体吗?可以,但要注意响应已写出时只能追加,改写需在写出前拦截。
06.6.1.2-002 全局中间件与分组中间件怎么挂载?
一句话结论
r.Use(...) 挂全局,r.Group("/x", mw) 挂分组;同一中间件可复用;需要隔离的能力(鉴权、限流)按组挂载,不强行全局化。
概念解释
全局中间件作用于所有路由,分组中间件只作用于该组。挂载层级决定生效范围,避免在不需要鉴权的公开路由上误挂鉴权中间件。
示例
r.Use(Logger(), Recover())
api := r.Group("/api", Auth()) // 仅 /api 下鉴权
常见误区
- 把业务专属中间件挂全局:污染健康检查、公开接口等不需要的路由。
- 重复挂载同一中间件:逻辑执行两次,日志/计数翻倍。
追问
- 单个路由能否挂中间件?可以,注册路由时传入额外 Handler。
- 中间件依赖如何注入?中间件闭包持有装配好的服务实例。
06.6.1.2-003 context.Context 如何贯穿调用链?
一句话结论
请求根 Context 从 c.Request.Context() 取出,沿函数参数逐级向下传递;下游 HTTP、数据库、RPC 调用都接收同一个 Context,用于取消传播与超时控制;Context 只传请求域信息,不存业务参数。
概念解释
Context 是请求范围的取消与元数据通道。传递方向自上而下,取消信号自上而下广播;请求结束后 Context 被取消,所有派生操作应及时退出。
示例
func (s *UserService) Get(ctx context.Context, id string) (*User, error) {
return s.repo.Find(ctx, id)
}
常见误区
- 把 Context 放结构体字段:请求边界被模糊,取消无法逐级追踪。
- 在 Context 里塞大量业务参数:违背其职责,应显式传参。
追问
- Background 什么时候用?作为根 Context(如后台任务),请求处理不要用 Background 顶替请求 Context。
- Context 值怎么用?只放请求域元数据(traceID 等),不放可计算的业务参数。
06.6.1.2-004 超时与取消怎么设置?
一句话结论
每请求用 context.WithTimeout 派生带截止时间的 Context,向下传递;客户端调用与数据库查询都传 Context;监听 ctx.Done() 及时退出,避免 goroutine 空转;超时预算沿调用链分层分配。
概念解释
超时防止请求挂死耗尽资源。父 Context 取消会级联取消子 Context。预算要分层:入口超时大于下游调用超时,预留处理余量。
示例
ctx, cancel := context.WithTimeout(c.Request.Context(), 3*time.Second)
defer cancel()
user, err := svc.Get(ctx, id)
常见误区
- 调用下游不传 Context:下游挂死时上游无法取消,goroutine 泄漏。
- 忘记
cancel():即使提前返回,资源也应释放,defer cancel 是惯例。
追问
- 超时后下游仍在执行怎么办?下游读到取消后退出;涉及写操作需保证幂等或补偿。
- 超时预算怎么定?依据 P99 响应时间与下游能力分层设置,压测后调整。
06.6.1.2-005 统一错误响应怎么设计?
一句话结论
定义领域错误类型携带错误码与消息,Handler 统一转换为 JSON 响应;错误区分可对外暴露与内部细节;日志记录内部错误与 traceID,响应只给业务码与可读消息。
概念解释
错误分层:底层错误(DB、网络)包装为领域错误,传输层只映射领域错误。自定义错误类型可实现 Code()/Message() 方法,响应转换集中在一处。
示例
type AppError struct {
Code string
Message string
HTTP int
}
func (e *AppError) Error() string { return e.Message }
常见误区
- 直接把
err.Error()抛给客户端:可能泄漏 SQL、路径与内部结构。 - 所有错误都返回 500:参数问题、未授权等应映射到 4xx。
追问
- 底层错误怎么包装?
fmt.Errorf("...: %w", err)保留链,对外转换时不取内部消息。 - 错误码放哪?集中定义枚举,避免散落字符串。
06.6.1.2-006 错误码与 HTTP 状态码如何映射?
一句话结论
HTTP 状态码表达传输层结果(2xx 成功、4xx 客户端错误、5xx 服务端错误),业务错误码表达具体业务结果;两者都在响应体中返回,映射规则集中维护;未识别错误统一归为 500 且不暴露细节。
概念解释
业务码可细分(参数非法、未登录、无权限、资源不存在、下游异常),HTTP 大类表达性质。前端按业务码处理分支,按 HTTP 识别通用失败类型。
常见误区
- 所有业务失败都返回 200 再加业务码:HTTP 语义丢失,网关与监控难以分类。
- 用 404 表达一切找不到:应区分资源不存在与接口不存在。
追问
- 权限不足映射几?403;未认证映射 401;参数错误 400;资源不存在 404。
- 下游故障返回什么?502/503 视场景,业务码标记下游异常,内部告警。
06.6.1.2-007 panic 恢复中间件怎么做?
一句话结论
最外层中间件 defer recover() 捕获 panic,记录堆栈与请求信息,返回 500 统一响应;不恢复的 panic 会导致进程崩溃或连接中断; recovered 后请求按错误路径返回,不能再写已中断的响应。
概念解释
Go 运行时 panic 沿栈向上展开,中间件在最外层兜住。恢复是最后防线,不能替代显式错误处理;堆栈只进日志。
示例
func Recover() gin.HandlerFunc {
return func(c *gin.Context) {
defer func() {
if r := recover(); r != nil {
log.Printf("panic: %v", r)
c.JSON(500, gin.H{"code": "INTERNAL"})
}
}()
c.Next()
}
}
常见误区
- 用 recover 兜底后继续正常写响应:panic 后栈状态已异常,应走错误返回。
- 只在 Handler 层恢复:异步 goroutine 内的 panic 不会被请求中间件捕获,需自行防护。
追问
- goroutine 内 panic 谁负责?每个衍生 goroutine 入口自行 recover,否则会崩进程。
- 生产应该主动 panic 吗?业务错误用 error 返回,panic 只用于不可恢复的编程错误。
06.6.1.2-008 日志中间件与 traceID 怎么落地?
一句话结论
入口中间件生成或透传 traceID,写入响应头与日志上下文;请求日志记录方法、路径、耗时、状态码;业务日志携带同一 traceID,便于串联一次请求的全部日志。
概念解释
traceID 是请求在日志与链路中的标识。中间件在请求进入时建立,Context 向下传递,日志输出时附带。跨服务调用通过请求头透传同一 ID。
常见误区
- 各层日志不带同一标识:线上排查无法串联调用链。
- 记录完整请求体与敏感参数:隐私与日志体积问题,需脱敏。
追问
- traceID 从哪来?入口没有则生成,有则透传上游传入值。
- 日志格式?结构化键值对,便于采集系统解析检索。
06.6.1.2-009 参数校验错误如何返回字段级提示?
一句话结论
绑定/校验失败后把 validator 错误转换为字段到消息的映射,响应体携带字段名与可读提示;HTTP 400,业务码标识参数错误;不在响应里堆砌原始校验引擎错误。
概念解释
字段级错误让前端定位到具体输入项。转换层把框架错误翻译为统一结构,校验引擎变化不影响对外契约。
常见误区
- 只返回一句"参数错误":前端无法定位字段。
- 直接序列化 validator 内部错误:结构与文案耦合校验库版本。
追问
- 跨字段错误怎么放?字段列表留空或用特殊字段名,消息说明规则。
- 校验失败日志要不要记?记摘要即可,不记录敏感输入。
06.6.1.2-010 errgroup 如何管理并发任务?
一句话结论
errgroup.Group 派生带取消的 Context 并启动多个 goroutine,等待全部结束或首个错误;任一任务返回错误即取消其他任务;适合 fan-out 聚合调用,避免手动 WaitGroup 加错误收集。
概念解释
errgroup 在 WaitGroup 基础上加错误传播与 Context 取消。任务返回 error 后 Wait() 返回首个错误,派生 Context 被取消,其他任务应监听退出。
示例
g, ctx := errgroup.WithContext(ctx)
for _, id := range ids {
id := id
g.Go(func() error { return svc.Load(ctx, id) })
}
if err := g.Wait(); err != nil { return nil, err }
常见误区
- 循环变量捕获错误:
id闭包共享,需在循环内赋值局部变量。 - 任务不监听 ctx 取消:出错后其他任务仍继续跑,浪费资源。
追问
- 并发度怎么控?errgroup 本身不限并发,需配合信号量/ worker pool 限制同时运行数。
- 部分任务失败要降级怎么办?收集结果与错误,按策略决定是否返回部分数据。
06.6.1.2-011 如何防止 goroutine 泄漏?
一句话结论
goroutine 必须有退出路径:监听 ctx.Done()、channel 关闭或明确的退出信号;等待的 channel 要有发送方关闭或超时;启动时即考虑它何时结束。
概念解释
泄漏 goroutine 会长期占用栈与堆,随请求累积耗尽内存与调度资源。常见原因:channel 永远不关闭、忘记取消、没有退出条件的循环。
常见误区
- 启动 goroutine 不写退出条件:请求结束后 goroutine 仍阻塞等待。
- 把 Context 换成 Background:取消信号传不到,goroutine 无法跟随退出。
追问
- 怎么排查泄漏?pprof goroutine 视图看数量增长与阻塞位置(见 06.6.1.5)。
- 后台常驻任务怎么管理?生命周期由应用启动/退出统一控制,不随请求创建。
06.6.1.2-012 重试策略怎么设计?
一句话结论
重试只用于幂等、可重试的错误(网络抖动、临时 5xx);指数退避加抖动与最大次数上限;非幂等写操作不盲目重试;重试预算计入整体超时。
概念解释
重试放大流量,必须有边界:次数、退避间隔、抖动避免同步重试风暴。可重试错误与不可重试错误(参数错、鉴权失败)要区分。
常见误区
- 对非幂等接口自动重试:重复扣款、重复下单等副作用被放大。
- 重试无上限或固定间隔:下游雪崩时重试加剧拥塞。
追问
- 哪些错误不重试?4xx 客户端错误、鉴权失败、参数非法。
- 退避怎么算?基础间隔 × 指数增长,加随机抖动,封顶间隔(具体实现以库文档为准)。
06.6.1.2-013 数据库调用如何传递上下文?
一句话结论
查询与执行方法接收 ctx context.Context,用 QueryContext/ExecContext;超时与取消能到达数据库驱动,避免连接被挂死请求长期占用;上下文取消后数据库操作应返回错误。
概念解释
数据库是常见下游,请求取消后仍持有的连接会挤占连接池。Context 传入驱动后,取消可中断等待中的查询(驱动与数据库支持范围以实际为准)。
常见误区
- 用
Query不传 Context:无法跟随请求超时取消,连接被长尾请求占住。 - 事务内跨请求复用 Context:事务生命周期与 Context 取消边界要对齐。
追问
- 连接池超时与请求超时什么关系?两者各自配置,请求超时应早于连接获取与查询超时。
- 取消后事务怎么办?回滚事务,归还连接。
06.6.1.2-014 中间件执行顺序如何控制?
一句话结论
按"恢复 → 日志/trace → 限流 → 鉴权 → 业务 Handler"排列:最外层兜底与观测,靠近 Handler 做鉴权与参数处理;顺序在路由装配处集中定义,不靠隐式默认。
概念解释
顺序决定谁能看到谁:恢复必须最外层;鉴权早于业务但晚于日志(要记录被拒绝请求);限流应在鉴权前保护系统。
常见误区
- 鉴权挂在日志之后却不记录拒绝:排查不到未授权尝试。
- 业务中间件顺序依赖偶然:新成员看不出链结构,应在装配处明确。
追问
- 分组能否覆盖全局顺序?分组中间件在全局之后插入,不能调整全局已执行部分。
- 中间件依赖状态怎么办?通过闭包注入,不要依赖全局可变状态。
06.6.1.2-015 请求 ID 如何贯穿日志与下游?
一句话结论
入口中间件生成 traceID 放入 Context,响应头回写;调用下游时从 Context 取出放到请求头;所有日志输出携带该 ID;ID 在全链路唯一,便于跨服务检索。
概念解释
贯穿靠 Context 与请求头两层:进程内用 Context 传递,跨服务用 HTTP/gRPC 头携带。日志采集按 ID 聚合一次调用的全部记录。
常见误区
- 下游调用不带 ID:链路在服务边界断开。
- ID 每次日志随机生成:同一请求多条日志无法关联。
追问
- 用什么头名?团队约定统一(如
X-Trace-Id),网关与下游都识别。 - 性能采样时 ID 还有用吗?全量日志仍带 ID,采样决策不影响标识。
06.6.1.2-016 内部错误如何记录又不对外泄漏?
一句话结论
错误经日志记录堆栈、上下文与 traceID;对外响应只含业务码与可读消息;敏感信息(SQL、凭据、内部路径)不写入响应;日志出口做脱敏。
概念解释
内部细节用于排查,外部响应用于协作。两层信息分开:日志面向运维,响应面向调用方。
常见误区
c.JSON(500, err):直接把内部错误对象序列化出去。- 日志打印完整凭据:应在记录前脱敏字段。
追问
- 错误链怎么保留?
%w包装,日志打印链上最内层与消息;对外不展开链。 - 什么时候可以把细节返回内部调用方?内部服务间约定的调试响应,仍需控制范围。
06.6.1.2-017 Echo 中间件机制与 Gin 有何对应?
一句话结论
Echo 中间件同样包裹 Handler,按顺序执行,可短路返回错误;概念一一对应,签名类型不同;业务错误处理与 Context 取消的思路两框架通用。
概念解释
中间件范式跨框架一致:前置逻辑、放行、后置逻辑、短路。差异在上下文类型与错误返回方式,迁移时改薄层即可。
常见误区
- 认为中间件逻辑框架绑定:横切关注点(日志、鉴权、恢复)与框架无关。
- 直接复制 Gin 中间件到 Echo:API 调用需按 Echo 上下文改写。
追问
- Echo 如何短路?中间件直接
c.JSON返回并return,不调用下游 Handler。 - 标准库中间件能否复用?实现
func(http.Handler) http.Handler签名的可包装适配。
06.6.1.2-018 取消后资源如何清理?
一句话结论
监听 ctx.Done() 后释放占用:关闭事务、归还连接、停止异步写入、退出衍生 goroutine;清理逻辑放在 defer 或退出分支;确保取消不会留下悬挂资源。
概念解释
请求取消不等于资源自动释放:连接、锁、channel、后台任务需要显式清理。Context 取消只是信号,资源回收靠代码路径处理。
常见误区
- 只返回错误不清理:连接与 goroutine 仍占着资源。
- 清理动作自身阻塞:清理应快速完成,必要时加超时。
追问
- 事务在取消时怎么处理?回滚并归还连接,避免连接悬挂在未结束事务上。
- 消息消费取消后怎么保证不丢?见队列消费幂等与确认机制(06.6.1.5)。