用途:为使用 Node.js 构建生产级后端服务提供系统性指导,适用于 REST API/GraphQL 服务、微服务、鉴权授权、可扩展后端架构、中间件与错误处理、SQL/NoSQL 数据库集成、WebSocket 实时应用及后台任务处理等场景。
主要能力:涵盖 Express(极简框架)与 Fastify(高性能框架)的基础搭建,包括 helmet、cors、compression 等安全与压缩中间件,以及请求日志与 TypeScript 类型化路由。架构上介绍分层架构(controllers/services/repositories/models/middleware/routes/utils/config/types)与依赖注入。中间件模式包含 JWT 鉴权与角色授权、基于 Zod 的输入校验、基于 Redis 的限流、基于 Pino 的请求日志。错误处理提供自定义错误类(ValidationError、NotFoundError、UnauthorizedError 等)、全局错误处理器与异步错误包装。
使用方式:作为技能文档查阅,按需参考对应章节与代码模式;更完整的依赖注入容器、数据库事务、JWT 刷新令牌、Redis 缓存与统一响应格式等实现见 references/advanced-patterns.md,测试指导见 javascript-testing-patterns 技能。
最佳实践与限制:建议使用 TypeScript、环境变量管理密钥、结构化日志、限流、生产环境启用 HTTPS 与规范 CORS、连接池、健康检查与优雅关闭。文档为通用模式集合,未提供具体安装命令、版本要求、收费或性能指标等信息,相关细节暂未提供。