一款基于 NestJS 的 DDD 脚手架,开箱即用,供需要的人参考
一个基于 NestJS 10 + TypeORM 的领域驱动设计( DDD ) Node.js 脚手架,内置双数据库、领域事件、统一响应、Swagger 文档与 Docker 一键启动示例。
这是什么
nestjs-ddd 是一个面向 Node.js / TypeScript 的 DDD 工程脚手架,帮你用几分钟时间搭好一个符合 DDD 分层规范的后端服务。
项目内置 用户( User ) 和 订单( Order ) 两个示例聚合,用户库走 MySQL 、订单库走 PostgreSQL ,包含 15 个 REST 接口、领域事件发布与监听、Swagger 文档、Docker Compose 一键启动。
功能与 gin-ddd / springboot4ddd 对齐,便于对比不同语言栈在 DDD 工程中的落地差异。
- 项目目录:
practice-projects/nestjs-ddd/ - 源码地址:https://github.com/microwind/design-patterns
- 开发指南:
NestJS-DDD-Development-Guide.md
| 层 | 关注点 | 约束 |
|---|---|---|
| 接口层 | HTTP 协议适配( VO / 路由 / 过滤器) | 不写业务逻辑 |
| 应用层 | 用例编排、事务、DTO / Command | 只依赖领域层 |
| 领域层 | 业务规则、聚合、领域事件、仓储接口 | 零框架依赖 |
| 基础设施层 | TypeORM 、消息、邮件等技术实现 | 向上实现领域接口 |
一句话:MVC 按技术切,DDD 按业务切。业务越复杂,DDD 的价值越明显。
为什么 Node.js 也要用 DDD ?
有人会觉得:Node.js 是不是写写脚本、BFF 就够了,没必要用 DDD ?
结论很简单:用不用 DDD 和语言无关,和业务复杂度有关。
- 小项目:NestJS 默认的
Module / Controller / Service三件套就够用,没必要上 DDD 。 -
中大型项目(模块超过 10 个、接口超过 50 个、业务规则密集),很容易出现:
- Service 越写越臃肿,一个方法里掺杂参数校验、业务规则、事务、事件、ORM 细节;
- 对象退化成只有 getter/setter 的"贫血模型",业务散落在各个 Service ;
- 新来的人看不懂代码结构在表达什么业务。
-
这时候用 DDD 就能把代码按业务语义重新切清楚:
- 聚合根 持有业务规则,不再被 Service 侵蚀;
- 应用服务 只负责编排和事务,职责非常薄;
- 仓储接口 + 依赖倒置 让领域层完全独立于数据库/框架。
- TypeScript + NestJS 特别适合落地 DDD:强类型表达值对象/聚合,装饰器 + DI 天然契合依赖倒置,几乎不用造轮子。