用途
backend-patterns 是一个后端架构模式与最佳实践参考集合,面向使用 Node.js、Express 以及 Next.js API Routes 构建服务端应用的开发者。资料说明其目标是为可扩展的服务端应用提供架构模式与写法示例,并建议根据项目复杂度选择合适的模式。
主要能力
资料中给出的模式主题包括:
- API 设计:基于资源的 RESTful 路由(GET/POST/PUT/PATCH/DELETE),使用查询参数进行过滤、排序与分页。
- 分层结构:Repository 模式抽象数据访问逻辑;Service 层承载业务逻辑并与数据访问分离;Middleware 模式以高阶函数包装处理器,实现请求/响应处理管线。
- 数据库模式:只选择所需列的查询优化、通过批量查询避免 N+1 问题、借助数据库函数在事务中写入关联数据。
- 缓存策略:Redis 缓存层与 Cache-Aside 模式,包括缓存命中、未命中回源与失效处理。
- 错误处理:集中式错误处理器区分业务错误、校验错误与未知错误;带指数退避的重试函数。
- 认证与授权:JWT 令牌校验、从 Authorization 头提取 Bearer 令牌,以及基于角色的权限映射与权限校验高阶函数。
- 限流:基于内存的简单速率限制器,按标识符与时间窗口计数。
- 后台任务:简易队列模式,将任务入队异步执行,避免阻塞请求。
- 日志与监控:结构化 JSON 日志,包含时间戳、级别、消息及请求上下文。
使用方式
该技能以代码示例形式呈现各模式,资料中包含 TypeScript/JavaScript 片段,例如定义 MarketRepository 接口与 Supabase 实现、withAuth 中间件包装 Next.js API 处理器、requirePermission 权限校验高阶函数、RateLimiter 类以及 Logger 类等。资料未提供安装命令、包依赖清单或具体的接入步骤,这部分暂未提供。使用时可按示例在项目中实现对应层与工具函数。
适用场景
资料列出的激活场景包括:设计 REST 或 GraphQL API 端点;实现 repository、service 或 controller 层;优化数据库查询(N+1、索引、连接池);添加缓存(Redis、内存、HTTP 缓存头);设置后台任务或异步处理;为 API 组织错误处理与校验;构建中间件(认证、日志、限流)。
限制
资料未说明适用平台、运行时版本要求、性能基准、收费或价格信息,均暂未提供。示例中出现的 Supabase、Redis、Zod、jsonwebtoken 等仅为代码片段中的用法演示,资料未说明其安装或配置方式。该技能提供的是模式参考而非可直接运行的完整库。