NestJS 从入门到精通 01：为什么选择 NestJS？全方位对比与首个 RESTful API 实战

一、Node.js 后端的困境：我们为什么需要 NestJS？

当你用 Express/Koa 写过万行级后台代码，是否经历过：

🔁 重复造轮子：用户认证/日志/错误处理重复编码
🧩 架构混乱：Middleware/Controller/Service 职责边界模糊

🦆 动态类型焦虑：req.body.userId 到底是 String 还是 Number？

// Express 项目常见的类型“猜谜游戏”
app.post('/users', (req, res) => {
const userId = req.body.userId // 这个id到底是字符串还是数字？
// 需手动验证类型...
});

💡 NestJS 的破局之道：
Angular 风格架构 + TypeScript 强类型 + 企业级 IOC 容器 = 开箱即用的 Node.js 企业级方案

二、三大核心优势解析

1. 分层架构：告别“意大利面条式”代码

分层	Express/Koa	NestJS
请求入口	散落的中间件	`@Controller` 路由集中管理
业务逻辑	混杂在路由中	`@Injectable` Service 隔离
数据操作	直接连接数据库	Repository 数据访问层封装

// NestJS 标准分层结构
@Controller('users')
export class UserController {
  constructor(private userService: UserService) {}  // 依赖注入
  
  @Post()
  createUser(@Body() dto: CreateUserDto) {          // DTO自动类型校验
    return this.userService.create(dto);            // 业务逻辑分离
  }
}

@Injectable()
export class UserService {
  constructor(private userRepo: UserRepository) {}  // 数据层隔离
  
  async create(dto: CreateUserDto) {
    return this.userRepo.save(dto);                // 仅关注业务规则
  }
}

2. TypeScript：从“类型猜谜”到编译期防护

DTO 数据自动校验（配合 class-validator）：

// 定义参数类型且自动验证！
export class CreateUserDto {
  @IsEmail()
  email: string;   // 编译期+运行期双重检查
  
  @Length(6, 20)
  password: string;
  
  @IsOptional()
  @Type(() => Number) // 自动转换类型
  age?: number;
}

3. 依赖注入：解耦的艺术

graph LR
A[UserController] -->|注入| B[UserService]
B -->|注入| C[UserRepository]
C -->|注入| D[Database]

只需声明依赖关系，框架自动解决对象创建与传递问题，大幅提升可测试性和模块化程度。

三、15分钟实战：创建你的第一个 RESTful API

步骤 1 - 环境准备

# 安装 CLI（确保 node>=16）
npm i -g @nestjs/cli

# 创建项目（选择使用 TypeORM）
nest new nest-hello-world --strict

步骤 2 - 生成核心资源

# 创建用户模块（自动生成 Controller/Service/Module）
nest g resource user --no-spec  # 回答 REST API

步骤 3 - 实现注册接口（Controller 层）

// user.controller.ts
import { Body, Controller, Post } from '@nestjs/common';

@Controller('users')
export class UserController {
  @Post('register')
  async register(@Body() createUserDto: CreateUserDto) { // 自动校验数据类型
    return `成功注册用户：${createUserDto.email}`;
  }
}

// === 参数类型定义（src/user/dto/create-user.dto.ts）===
import { IsEmail, IsNotEmpty } from 'class-validator';

export class CreateUserDto {
  @IsEmail({}, { message: '邮箱格式非法' })
  email: string;

  @IsNotEmpty({ message: '密码不能为空' })
  password: string;
}

步骤 4 - 启动并测试

npm run start:dev  # 热重载开发模式

使用 Postman 测试：

URL: POST http://localhost:3000/users/register

Body:

{
"email": "test@example.com",
"password": "123456"
}

成功响应：

"成功注册用户：test@example.com"

四、避坑指南：常见问题解决

❌ 错误 1：未安装验证器包

# 安装必需依赖
npm i class-validator class-transformer

❌ 错误 2：忘记启用全局验证管道

// main.ts 中激活验证（关键步骤！）
import { ValidationPipe } from '@nestjs/common';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe()); // 启用DTO自动验证
  await app.listen(3000);
}

五、延伸思考：NestJS vs Express/Koa

能力维度	Express/Koa	NestJS
开发速度	⭐️⭐️⭐️ 快速启动	⭐️⭐️ 需学习曲线
架构规范性	⭐️⭐️ 依赖个人能力	⭐️⭐️⭐️ 框架强约束
企业级功能	❌ 需手动集成	✅ 开箱即用
长期维护成本	⚠️ 随项目膨胀而升高	💚 模块化控制
TypeScript支持	🟡 社区方案	🟢 深度集成

📌 结论：
写 Demo/小型工具：Express/Koa 更轻快
构建长期迭代的企业应用：NestJS 工程化优势不可替代

六、下期预告

《NestJS 模块化架构：控制器/服务/数据层最佳实践》 将带大家：
➠ 拆解 @Module 的依赖管理黑魔法
➠ 实现用户注册全链路（Controller → Service → Repository）
➠ 用 TypeORM 完成真实 MySQL 数据库交互

互动议题：
✍️ 你有过 Node.js 项目的“架构失控”经历吗？欢迎评论区分享！