摘要

这篇文章拆解 NestJS 模块化 MVC 架构，以 Todos CRUD 为例演示 @Get / @Post / @Patch / @Delete 路由、依赖注入、参数提取还有 NotFoundException 的标准化错误处理。针对开发者常见痛点——模块耦合、错误统一格式难题、路由调试麻烦等，提供清晰的实现思路。

说到入口，工厂模式创建应用

main.ts 是 NestJS 应用的启动入口。使用 NestFactory 创建实例：

import { NestFactory } from '@nestjs/core';import { AppModule } from './app.module';async function bootstrap {
const app = await NestFactory.create;await app.listen;}
bootstrap，

NestFactory.create 把根模块传给工厂，让框架负责组装中间件、解析器与异常过滤器等底层细节。者只需声明“用哪个模块”，大幅降低配置门槛。

app.listen 启动 HTTP 服务；环境变量覆盖端口是云部署的通用做法。

再看根模块，模块组装与依赖声明

AppModule 是整个应用的根模块。用 @Module 装饰器声明：

import { Module } from '@nestjs/common';import { AppController } from './app.controller';说起来，import { AppService } from './app.service';import { TodosModule } from './todos/todos.module';@Module({
imports:,controllers:,providers:。})
export class AppModule {}

• imports: 引入其他业务模块；这里把 Todos 模块注入，让它在全局可用。
• controllers: 注册本模块下的控制器。
• providers: 注册服务提供者，Nest 的 IoC 容器会自动实例化并注入。

User Pain Point：很多人误以为每个控制器都要放在根模块中导致耦合度高。

TodosModule：独立业务模块

A todo 功能完全封装在一个独立模块里：

import { Module } from '@nestjs/common';怎么说呢，import { TodosService } from './todos.service';import { TodosController } from './todos.controller';@Module({
controllers:,providers:。})
export class TodosModule {}

No imports means no external dependencies—great for unit testing and future extension.

Controller：路由与参数提取

The controller focuses solely on routing and parameter extraction:

@Controller
export class TodosController {
constructor {}
@Get
findAll: Todo {
return this.todosService.findAll;}
@Get
findOne id: string): Todo {
return this.todosService.findOne);}
@Post
create title: string): Todo {
return this.todosService.create;}
@Patch
update(
@Param id: string,@Body patch: Partial。): Todo {
return this.todosService.update,patch);}
@Delete
remove id: string): { message: string } {
this.todosService.remove);return { message: '删除成功' };}
}

• The prefix “/todos” is set once via @Controller.
• 至于D.I.，constructor injects Todostservice;Nest’s IoC resolves it automatically.
• User Pain Point：在大型项目中，一些团队把业务逻辑写进控制器导致代码膨胀。坚持“薄控制”可以让每个文件职责清晰，也方便后期重构。
• The route parameters ) are always strings;converting to Number ensures type safety.
• The body extractor ) can pick specific fields or whole objects.

Service：业务逻辑与异常抛出

export interface Todo {
说到id，number;title: string;
complete: boolean;
}
let todos: Todo =;let nextId = todos.length +1;@Injectable
export class TodosService {
findAll: Todo {
return todos;}
findOne: Todo {
const todo = todos.find;if throw new NotFoundException;return todo，}
从create来看，Todo {
const todo:{id:number,title:string。complete:boolean}={
再看id，+nextId++,title,complete:false
};todos.push，return todo;}
再看remove，void{
const index= todos.findIndex;说起来，if throw new NotFoundException;todos.splice;}
从update来看，Todo{
const todo=this.findOne;// may throw
Object.assign;return todo，}
}

• User Pain Point：手动管理内存数组易导致状态不一致，在生产环境通常需要换成数据库查询或缓存层。但这个例子展示了快速原型开发时的便利性。
• 说到统一，每次找不到资源时直接抛出 {@link NotFoundException}。Nest 自动转换为 JSON 响应，而不是自己写 try/catch 再返回结构。
• 内置异常类列表：

  异常类	状态码
  BadRequestException	400 参数校验失败
  UnauthorizedException	401 未登录
  ForbiddenException	403 无权限
  NotFoundException	404 数据不存在
  ConflictException	409 重复创建等冲突
  InternalServerErrorException	500 内部错误

请求流程这方面，从路由到响应完整链路

1. HTTP 请求到达内置服务器。
2. Nest 路由解析器匹配到 @Controller/@Get,调用对应方法。
3. @Param 提取 URL 参数；@Body 把请求体映射为对象。
4. 调用 Service 层的方法执领域务逻辑。
5. 若成功，返回实体对象；若失败抛出 NotFoundException。
6. Nest 异常过滤器捕获异常，将其转换为标准 JSON 响应，例如：
json { "statusCode":404。"message":"Todo 1 不存在","error":"Not Found"} ` **MVC 主要** ： Controller 薄 → Service 厚 → 错误统一。话说回来，

---

使用者痛点快捷方式

痛点	原因	推荐做法
过度耦合	控制器里写满了查询/验证/事务代码	把所有业务拆到 Service；保持 Controller 单纯负责路由和参数
错误格式不一致	自己手写 try/catch 导致前端难以统一处理	使用 Nest 内置 HttpException 系列，只抛异常即可
调试路由困难	方法参数没提示或拼写错误导致频繁报错	在 Controller 中加上 TypeScript 接口校验或 DTO + ValidationPipe
数据持久化难题	用数组跑完测试后迁移到数据库复杂	用 Repository 或 ORM替换数组；接口保持不变

---

小结

NestJS 的模块化 MVC 架构通过：
• @Module 把业务单元组装成独立可复用组件
• @Controller 做薄层路由和参数提取
• @Injectable 声明可注入服务。实现厚业务逻辑
• 内置 HttpException 系列保证错误统一输出

这种分层设计让每个文件职责单一，易于测试与维护，也能快速对接数据库或缓存层，从而可以解决开发中的常见痛点。