用途:为构建可扩展、可维护、生产就绪的 Node.js 后端应用提供系统化指导,适用于 REST API、GraphQL 服务、微服务、实时应用与后台任务处理。
主要能力:涵盖 Express.js 与 Fastify 两大框架的基础搭建,包括安全中间件(helmet、cors、compression)、请求体解析与日志。架构层面给出分层架构(controllers/services/repositories/models/middleware/routes/utils/config/types)与依赖注入容器两种模式,并附控制器、服务、仓储各层示例。中间件部分包含 JWT 认证与角色授权、基于 Zod 的请求校验、基于 Redis 的限流(apiLimiter、authLimiter)以及 pino 请求日志。错误处理提供自定义错误类(AppError、ValidationError、NotFoundError、UnauthorizedError、ForbiddenError、ConflictError)、全局错误处理器与 asyncHandler 异步包装。数据库部分演示 PostgreSQL 连接池配置与仓储层增删改查。
使用方式:作为技能加载后,按需参考对应章节的代码模式与目录结构,将示例适配到自身项目;示例使用 TypeScript,依赖 express、fastify、helmet、cors、compression、jsonwebtoken、zod、express-rate-limit、rate-limit-redis、ioredis、pino、pg、bcrypt 等包。
适用场景:搭建 REST/GraphQL API、微服务、认证授权体系、数据库访问层、WebSocket 实时应用与后台任务。
限制:资料未提供具体安装命令、版本要求、性能基准、收费信息与平台支持范围;示例代码需结合项目实际调整,生产环境密钥与配置需自行管理。