Node.js 后端模式
面向构建可扩展、易维护、可用于生产环境的 Node.js 后端应用,提供结合现代框架、架构模式与最佳实践的综合指导。
适用场景
- 构建 REST API 或 GraphQL 服务
- 使用 Node.js 创建微服务
- 实现认证与授权
- 设计可扩展的后端架构
- 搭建中间件与错误处理
- 集成数据库(SQL 与 NoSQL)
- 构建基于 WebSockets 的实时应用
- 实现后台任务处理
详细模式与完整示例
详细的模式文档位于 references/details.md。当上述导航层级信息不足时,请阅读该文件。
最佳实践
- 使用 TypeScript:类型安全可防止运行时错误
- 实现完善的错误处理:使用自定义错误类
- 校验输入:使用 Zod 或 Joi 等库
- 使用环境变量:切勿硬编码密钥
- 实现日志记录:使用结构化日志(Pino、Winston)
- 添加限流:防止滥用
- 使用 HTTPS:生产环境始终启用
- 正确实现 CORS:生产环境不要使用 *
- 使用依赖注入:便于测试与维护
- 编写测试:单元测试、集成测试与端到端测试
- 处理优雅关闭:清理资源
- 使用连接池:用于数据库
- 实现健康检查:用于监控
- 使用压缩:减少响应体积
- 监控性能:使用 APM 工具
测试模式
全面的测试指导请参见 javascript-testing-patterns 技能。