生产级后端架构模式指南

后端架构最佳实践指南，涵盖API设计、数据库优化、缓存策略与认证授权模式，S级安全认证的教育性文档。

基本信息

• 技能名称?Backend Patterns
• 中文名称?生产级后端架构模式指南
• 作者?charmmm718
• 分类?专业技能
• 版本?0.1.2
• 标签?backend, api-design, rest-api, typescript, nodejs, nextjs, database-optimization, caching, authentication, jwt, rbac, rate-limiting, repository-pattern, service-layer, middleware, error-handling, supabase

使用方法

使用说明
核心用法
本 Skill 提供完整的后端开发模式参考，主要包括：
API 设计模式 ：RESTful 资源路由结构、查询参数过滤与分页、Repository 模式抽象数据访问、Service 层分离业务逻辑、中间件模式处理认证与请求管道。
数据库优化 ：精确列选择避免 SELECT * 、批量查询解决 N+1 问题、Supabase RPC 事务保证数据一致性。
缓存策略 ：Redis 装饰器模式实现透明缓存层、Cache-Aside 模式管理缓存失效。
错误处理 ：集中式 ApiError 类与 errorHandler、Zod 验证错误处理、带指数退避的重试机制（1s/2s/4s）。
认证授权 ：JWT Token 验证与刷新、基于角色的权限控制（RBAC）、中间件高阶函数封装权限检查。
系统治理 ：内存限流器（100 req/min）、简单任务队列异步处理、结构化 JSON 日志与请求追踪。
显著优点
实战导向 ：所有代码均为可直接运行的 TypeScript 示例，涵盖 Next.js API Routes、Express、Supabase 等主流技术栈
安全示范 ：JWT 验证示例正确展示环境变量使用方式，而非硬编码密钥
性能优化 ：N+1 查询解决方案、Redis 缓存装饰器、数据库事务模式均为生产级最佳实践
架构清晰 ：Repository-Service 分层、中间件管道模式支持复杂业务扩展
潜在局限
示例完整性 ：部分代码片段为简化演示（如 vectorSearch 未实现细节），需结合具体业务补全
无框架集成 ：未提供 NestJS、Fastify 等框架的专用适配，需手动迁移
队列简单 ：内置 JobQueue 为内存实现，无持久化能力，生产环境建议替换为 Bull/BullMQ
限流局限 ：内存限流器不支持分布式部署，多实例场景需改用 Redis-based 方案
适合人群
正在使用 Node.js/Next.js 构建 API 服务的全栈开发者
从单体应用向分层架构转型的团队技术负责人
需要快速查阅后端设计模式参考的高级开发者
学习后端架构最佳实践的初中级工程师
常规风险
该 Skill 为纯 Markdown 文档型 Skill，无可执行代码，扫描确认无网络请求、无文件系统操作、无敏感信息硬编码。唯一需注意的风险点（RISK-001）为教学性质的环境变量引用示例，属安全编码示范而非漏洞。用户在实际项目中需确保 JWT_SECRET 等配置通过真实环境变量注入，避免复制示例中的占位符。