第 3 章 卷层工坊：中间件开发与组合
第 3 章 · 卷层工坊：中间件开发与组合
章节摘要：本章跟着一个需求走——团队要给服务加上日志、鉴权、限流三层能力。怎么用规范的中间件实现、社区现成的轮子何时该用、自定义层怎么封装成可复用的工厂、层序怎样决定行为与性能，四节依次展开。
一条主线：为服务装配三层能力
第 2 章把洋葱芯解剖完了，内核交出的只是一条空队列——真正让服务长出能力的是中间件。本章的主线是一个典型任务：某接口服务上线前，技术评审要求补齐访问日志（谁在什么时候打了哪个接口、耗时多少）、登录鉴权（没带凭证的请求挡在外面）、接口限流（防刷防爬）三件事。围绕这个任务，我们走四站：先弄懂中间件函数的签名与异步规范（3.1），这一站是所有后续工作的语法基础；再看社区有哪些现成层可直接拿来（3.2），能轮子就轮子；然后亲手把日志与限流封装成带配置的中间件工厂（3.3），这是"卷层"的核心手艺；最后研究层序——同样的层，叠放顺序不同，行为和性能都天差地别（3.4）。
沿途站点
- 3.1 中间件签名与异步规范——
async (ctx, next)的完整契约：进层出层的两段结构、截停的合法姿势、层内异常的抛法，以及如何为单个中间件写单元测试。 - 3.2 常用中间件选型与用法——路由、请求体解析、静态资源、压缩、安全头五个高频轮子的安装与装配，顺带给出选型原则：先看维护活跃度，再看是否单一职责。
- 3.3 自定义中间件模式与复用——把写死参数的中间件升级成配置化工厂，覆盖日志、限流两个完整实现，并给出发布与复用的最小规范。
- 3.4 层序控制与性能影响——用可复现的实验说明"顺序改变行为"的三类案例，以及层序如何影响每请求开销。
拐点与结论
本章的认知转折藏在 3.3：多数人写自定义中间件时，第一版都是"能跑就行"的匿名函数，等第二个接口也要用同样的日志逻辑时才开始痛苦。转折点在于意识到中间件是服务的一等公民，值得像业务模块一样设计与测试——工厂函数封装配置、参数校验前置、行为用单元测试钉死，这些手段一样适用于那几十行的中间件。结论随之而来：洋葱模型的价值不在于框架自带多少层，而在于你自己能以稳定的成本不断卷出新层。
本章四站的关系如下图。
图 3-0：卷层工坊的全景流水线
本章任务的验收口径
主线任务（日志、鉴权、限流三层）做到什么程度算完成？给出可核对的验收口径，免得"写完了"停留在感觉上。日志层：任意接口的访问在日志里能查到方法、路径、状态码与耗时，且内层异常发生时日志依然落盘；健康检查路径被默认跳过。鉴权层：无凭证、假凭证、过期凭证分别得到明确的 401，合法凭证把用户身份写入 ctx.state.user，角色不匹配得到 403——这四个分支各有一条单元测试钉住。限流层：超过配额的请求得到 429 并带 Retry-After 头，配额余量通过响应头可见，配置错误在启动阶段就报错。这三条口径同时也是 8.3 节集成测试的用例来源——工坊出产的标准，从这一章就立起来。
读完你应该
- 能按签名规范独立写出日志、鉴权类中间件，并通过单元测试验证截停与放行两种路径；
- 能为一个新项目选齐路由、解析、静态、压缩、安全头五类轮子并正确装配；
- 能把任意"写死参数"的中间件重构为配置化工厂，说清默认值与参数校验怎么放；
- 能对给定的中间件栈指出顺序错误并解释后果，说出装配顺序的排布原则；
- 能估算一个新中间件给每个请求增加的开销量级，并判断是否值得。
下一章的接力
三层能力装配完毕，洋葱已经有了扎实的外壳。下一章请求终于要真正"进层"：路由如何匹配、RESTful 接口如何设计、参数如何解析、文件如何流式进出——第 4 章把镜头对准请求处理的主战场。