用途:为 Express.js 后端 API 开发提供可复用的框架模式,强调清晰路由、中间件组合与规范的请求/响应处理。适用于创建或修改 Express 路由、构建认证/校验/错误处理中间件、操作 Request/Response 对象、实现 BaseController 模式及处理 Express 错误。
主要能力:
- 干净路由模式:路由只定义路径、注册中间件、委托给控制器,不写业务逻辑、不直接访问数据库、不做校验或复杂响应格式化。
- BaseController 模式:提供 handleError、handleSuccess、withTransaction、addBreadcrumb 等方法,统一错误处理与响应格式,并集成 Sentry 上报。
- 中间件模式:包含基于 JWT 的登录状态校验(SSOMiddlewareClient.verifyLoginStatus)、基于 AsyncLocalStorage 的审计上下文(auditMiddleware、getAuditContext)、错误边界(errorBoundary)与异步错误包装(asyncErrorWrapper)。
- 中间件顺序规则:Sentry 请求处理器最先,其次 body/cookie 解析,再注册路由,错误处理器放在路由之后,Sentry 错误处理器最后。
- 请求/响应处理:支持 TypeScript 类型化请求,约定成功、创建、错误等响应结构与常用 HTTP 状态码。
使用方式:按资料中的模式组织代码,路由委托控制器,控制器继承 BaseController 并调用 handleSuccess/handleError,全局注册 errorBoundary 与 Sentry 处理器。
适用场景:构建可扩展的 Express 后端 API、需要统一错误处理与审计上下文的 Node.js 服务。
限制:资料未提供安装命令、版本要求、收费信息或性能数据;相关技能包括 nodejs、backend-dev-guidelines、prisma。