如何解决NestJS Fastify中的TypeError: response.status(...).json is not a function错误

这个错误太常见了——你在自定义的HttpExceptionFilter里用了Express那套响应写法，但Fastify的响应对象（也就是reply）和Express的responseAPI完全不一样，所以才会报这个错。下面给你一步步解决的方案：

1. 修改异常过滤器的响应写法 #

先看看你之前的过滤器代码，大概率是这样的（典型的Express风格）：

@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter {
  catch(exception: HttpException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse();
    const status = exception.getStatus();

    // 这里就是问题所在：Fastify不支持这种链式调用
    response.status(status).json({
      statusCode: status,
      timestamp: new Date().toISOString(),
      message: exception.message,
    });
  }
}

把它改成Fastify专属的replyAPI写法：

@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter {
  catch(exception: HttpException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    // Fastify中getResponse()拿到的是reply对象，不是Express的response
    const reply = ctx.getResponse();
    const status = exception.getStatus();

    // Fastify用code()设状态码，send()发JSON响应
    reply.code(status).send({
      statusCode: status,
      timestamp: new Date().toISOString(),
      message: exception.message,
    });
  }
}

2. 确保全局注册时适配Fastify #

如果你的过滤器是全局注册的，在main.ts里要明确使用NestFastifyApplication类型，避免类型混淆：

import { NestFactory } from '@nestjs/core';
import { NestFastifyApplication, FastifyAdapter } from '@nestjs/platform-fastify';
import { AppModule } from './app.module';
import { HttpExceptionFilter } from './common/http/http-exception.filter';

async function bootstrap() {
  const app = await NestFactory.create<NestFastifyApplication>(
    AppModule,
    new FastifyAdapter(),
  );
  // 注册全局过滤器
  app.useGlobalFilters(new HttpExceptionFilter());
  await app.listen(3000);
}
bootstrap();

3. 可选：添加类型检查（更严谨的写法） #

如果你想避免以后再犯类似的类型错误，可以给reply加上Fastify的类型声明：

import { Catch, HttpException, ArgumentsHost } from '@nestjs/common';
import { ExceptionFilter } from '@nestjs/core';
// 引入Fastify的Reply类型
import { FastifyReply } from 'fastify';

@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter {
  catch(exception: HttpException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    // 明确指定类型，IDE会提示正确的API
    const reply = ctx.getResponse<FastifyReply>();
    const status = exception.getStatus();

    reply.code(status).send({
      statusCode: status,
      timestamp: new Date().toISOString(),
      message: exception.message,
    });
  }
}

为什么会出现这个错误？ #

NestJS默认的异常处理逻辑是为Express设计的，当你切换到Fastify作为底层HTTP框架时，请求/响应对象的API发生了变化：

• Express里的response.status()返回的是Response实例，可以链式调用json()发送响应
• Fastify里的reply.code()返回的是Reply实例，没有json()方法，而是用send()来发送各种类型的响应体（包括JSON）

只要把过滤器里的响应写法换成Fastify的API，这个错误就会消失。

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