Fastify中Reply was already sent错误排查：NestJS与Express差异

代码示例 #

export class SessionController {
  constructor(private sessionService: SessionService) {}

  @Post('login')
  async login(
    @Req() req: FastifyRequest,
    @Body() params: LoginDto,
    @Res() reply: FastifyReply,
  ) {
    params.ipAddress = req.socket.remoteAddress; /* ::1 */
    this.sessionService
      .signin(params)
      .then((user) => {
        reply.header('Authorization', `Bearer ${user.access_token}`);
        reply.code(201).send(user);
      })
      .catch((error) => {
        console.log(error instanceof HttpException);
        reply.status(error.status).send({ errors: [error.message] });
      });
  }
}

问题描述 #

我在基于Fastify的NestJS应用中编写了上述login接口，调用该API时收到“Reply was already sent”错误，代码中并未重复调用reply.send()。相同逻辑在Express中可正常运行，但改用async/await替代Promise的then/catch方式后错误消失，请指出错误原因并解释。

错误原因及解释 #

核心问题是NestJS对Fastify和Express的响应处理逻辑差异，以及你混用了async控制器方法与Promise链式调用：

1. NestJS的异步控制器规则：
   当控制器方法标记为async时，NestJS会默认监听该方法返回的Promise状态。如果方法没有返回一个明确的响应（或处理响应的Promise），框架会在方法执行完毕后自动尝试发送一个空响应。
   你在代码中用.then()手动调用了reply.send()，但方法本身没有返回这个Promise，NestJS无法感知你已经手动处理了响应，于是在方法执行结束后会再次触发默认响应发送，导致两次响应冲突，抛出“Reply was already sent”错误。

2. Express与Fastify的响应机制差异：
   Express对响应的处理更宽松，即使控制器方法是async且手动调用了res.send()，Express不会额外自动发送响应，所以相同逻辑在Express环境下不会触发错误。

3. 改用async/await后错误消失的原因：
   用async/await时，你可以将响应逻辑包裹在try/catch中，此时方法会等待await的Promise完成，NestJS能感知到你已经通过reply.send()手动处理了响应；或者你可以去掉@Res()装饰器，直接返回响应数据，让NestJS自动处理响应发送，两种方式都不会触发重复响应的问题。

内容的提问来源于stack exchange，提问作者Bennison J