NestJS Boot

外观

@maxtan/nest-core ​

NestJS 增强工具包，提供了一系列开箱即用的模块、装饰器、管道、过滤器和工具函数，帮助您快速构建高效、规范的 NestJS + Fastify 应用。

功能特性 ​

核心模块 ​

  • 🔐 授权模块 — 基于 JWT + Passport 的认证授权，内置 nestjs-cls 请求上下文，支持 Bearer Token、AES 加密 Payload
  • 📋 日志系统 — 基于 Winston 的日志方案，支持控制台、文件轮转、阿里云 SLS；LoggerModule DI 化
  • 💾 缓存模块 — 基于 Redis (ioredis) 的缓存服务，支持健康检查、自动重连、批量操作和对象序列化
  • 🗄️ Prisma 模块 — 声明式中间件（软删除 / 审计）、多数据源隔离、DMMF 自动发现、PrismaRepository 泛型 CRUD
  • 💚 健康检查 — 自动检测 Prisma / Redis、自定义指示器、K8s 探针就绪

请求处理 ​

  • ✅ 验证管道 — 基于 Zod v4 的请求验证，20+ 预处理器对齐 Prisma，Schema 即类型
  • 📦 文件上传 — Fastify Multipart 集成，支持 Zod Schema 验证表单字段、MIME 白名单、扩展名黑名单
  • 🔧 XML 解析 — 高性能 XML 解析装饰器，基于 fast-xml-parser，解析器实例缓存

响应与异常 ​

  • 🌐 响应转换 — 统一响应格式，自动 Date→时间戳转换，201→200 归一化
  • ⚠️ 异常过滤器 — 全局异常处理，Fastify 错误映射，雪花 ID 链路追踪
  • 📝 操作日志 — 基于拦截器的全链路操作记录，自动脱敏、异步写入

开发工具 ​

  • 🔄 事务装饰器 — @PrismaTransactional 声明式事务，自动嵌套复用
  • 🌱 环境变量校验 — validateEnv + zPort / zBoolEnv，启动即校验
  • 🛠️ 工具函数 — 雪花 ID、AES-256-GCM、LRU 缓存、Prisma 查询构建器、对象清理
  • 📐 Prisma→Zod — generateZodSuggestions 从 DMMF 自动生成 DTO 建议代码

快速入口 ​

文档目录 ​

入门 ​

核心功能 ​

数据库 ​

请求与响应 ​

进阶 ​