NestJS中HttpException未传status时返回201状态是否合理？

行为合理性结论 #

这个行为完全不合理，属于框架在异常处理边界场景下的疏漏，错误返回成功状态码会带来严重业务风险——客户端会误以为请求执行成功，进而触发错误的后续逻辑。

问题原因 #

在你使用的NestJS v8.0.4版本中，当HttpException构造函数传入undefined作为状态码时，框架的异常过滤器不会自动将其视为服务器错误，而是 fallback 到当前路由的默认响应状态码：

• 你的接口是POST请求，NestJS中POST路由默认响应状态码为201
• 异常过滤器未对status = undefined的情况做特殊处理，直接沿用了路由的默认状态

从你提供的日志也能看到，捕获到的原始BadRequestException本身带有400状态码，但重新包装成HttpException时传入undefined，导致框架丢失了错误状态的识别。

关于默认500的合理性 #

从业务逻辑和HTTP规范来看，当异常未指定明确状态码时，默认返回500（Internal Server Error）是更合理的选择——这符合"未明确分类的服务器错误"的语义，也能避免错误场景返回成功状态的风险。

这个问题在NestJS后续版本（如v9及以上）已经被修复：当HttpException未传入有效状态码时，框架会默认使用500作为响应状态。

修复方案 #

针对当前v8.0.4版本，你可以通过以下方式解决：

1. 复用原始异常的状态码 #

在重新抛出异常时，直接使用捕获到的原始异常的status属性：

async test() {
  try {
    throw new BadRequestException('Test Error');
  } catch (error) {
    // 复用原异常的响应内容和状态码
    throw new HttpException(error.response, error.status);
  }
}

2. 自定义全局异常过滤器 #

创建全局过滤器来处理status为undefined的HttpException，强制返回500状态：

import { ExceptionFilter, Catch, ArgumentsHost, HttpException } from '@nestjs/common';
import { Response } from 'express';

@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter {
  catch(exception: HttpException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse<Response>();
    // 当状态码未定义时，默认使用500
    const status = exception.getStatus() ?? 500;
    const message = exception.getResponse();

    response.status(status).json({
      statusCode: status,
      message: message,
    });
  }
}

然后在main.ts中注册：

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalFilters(new HttpExceptionFilter());
  await app.listen(3000);
}
bootstrap();

3. 升级NestJS版本 #

直接升级到v9及以上版本，框架会自动处理HttpException状态码未定义的情况，默认返回500。

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