NestJS 中的 controllers 是什么？

Question

Accepted Answer

**Controllers** 处理传入的 **HTTP 请求**并返回响应。它们定义应用程序的路由，充当入口点——接收请求、提取数据、委托给服务并返回结果。它们将路由关注点与业务逻辑分离开。

## 定义 controller

```ts
import { Controller, Get, Post, Body, Param } from "@nestjs/common";

@Controller("users")          // the route PREFIX → all routes start with /users
export class UsersController {
  constructor(private usersService: UsersService) {}   // inject a service via DI

@Get()                       // GET /users
  findAll() {
    return this.usersService.findAll();
  }

@Get(":id")                  // GET /users/:id
  findOne(@Param("id") id: string) {        // extract the route param
    return this.usersService.findOne(id);
  }

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {       // extract the request body
    return this.usersService.create(dto);
  }
}
```

## 工作原理：装饰器将方法映射到路由

```text
@Controller("users") → route prefix /users
@Get() / @Post() / @Put() / @Patch() / @Delete() → HTTP method + sub-path
Combined: @Get(":id") inside @Controller("users") → GET /users/:id
```

装饰器声明式地将类方法绑定到 HTTP 路由——清晰易读，无需手动注册路由。

## 参数装饰器提取请求数据

```ts
@Get(":id")
example(
  @Param("id") id: string,        // route parameter (/users/:id)
  @Query("sort") sort: string,    // query string (?sort=name)
  @Body() body: CreateUserDto,    // request body
  @Headers("authorization") auth: string,  // a header
  @Req() req: Request,            // the raw request object (rarely needed)
) {}
```

Nest 的参数装饰器（`@Param`、`@Query`、`@Body`、`@Headers`）能够清晰地提取你需要的数据——无需手动解析 `req`。

## Controller 应该保持 THIN

```ts
// ✅ controller delegates to a service — stays thin
@Post()
create(@Body() dto: CreateUserDto) {
  return this.usersService.create(dto);   // business logic lives in the SERVICE
}
// ❌ don't put database queries / business logic directly in the controller
```

最佳实践是：保持 controllers **精简**——它们只处理 HTTP 关注点（路由、提取数据、返回响应），将所有业务逻辑委托给 **services**。这种分离使代码易于测试且组织清晰。

## 为什么这很重要

Controllers 是 NestJS 的基础构件——是所有 HTTP 请求的入口点，也是定义 API 路由的地方。

理解装饰器（`@Controller`、`@Get`/`@Post`、`@Param`/`@Body`/`@Query`）如何声明式地将方法映射到路由并提取请求数据，是日常 NestJS 开发的基础知识——这是构建任何端点的方式。

同样重要的是保持 controllers **精简**（只处理 HTTP 关注点，将业务逻辑委托给注入的服务）的原则，这体现了 NestJS 的关注点分离哲学，使代码更易维护和测试。

Controllers 与 services 和 modules 一起，构成了每个 NestJS 应用程序的核心结构，使其从一开始就需要深入理解。