NestJS抛出的错误未传递到前端，反而返回200状态码问题排查

核心原因 #

你的问题出现差异的本质是两个关键点：

1. 原生Error未被Nest异常处理系统正确识别：Nest默认只对继承自HttpException的异常做标准化处理，原生Error可能在异步操作场景下无法被正确捕获并映射到对应HTTP状态码。
2. unlockNewRegistrations方法干扰了异常传播：你提到移除该方法调用后异常能正常抛出，说明这个方法的执行可能破坏了Nest的响应生命周期，比如内部存在未捕获的Promise异常、数据库事务逻辑冲突，或者间接导致响应提前发送。

修复步骤 #

1. 替换原生Error为Nest官方异常类 #

不要用throw new Error(...)，改用Nest内置的RequestTimeoutException（对应408状态码），让框架自动处理状态码和响应格式：

// 在仓库代码中导入并替换throw语句
import { RequestTimeoutException } from '@nestjs/common';

// ...
} else if (registrationQueueEntity.lockedByUser === adminId) {
    await this.unlockNewRegistrations(adminId, product);
    throw new RequestTimeoutException('REG_QUE_LOCK_INACTIVITY');
}

2. 排查unlockNewRegistrations方法 #

重点检查这个方法的实现：

• 确认方法内部没有未捕获的异常，所有Promise都被正确处理（避免异常吞噬）。
• 检查是否涉及数据库事务操作，确保事务的提交/回滚逻辑不会干扰后续代码执行。
• 绝对禁止在仓库/服务层直接操作响应对象（比如手动调用res.send），这会导致响应提前发送，后续的异常无法被处理。

3. 验证前端错误处理逻辑 #

即使服务器返回正确的错误状态码，部分前端请求库（比如fetch）默认不会将HTTP错误状态码视为Promise拒绝，导致前端误以为是200响应：

• 如果用fetch，需要手动判断状态：

  fetch('/api/users/new-registrations')
    .then(res => {
      if (!res.ok) {
        return res.json().then(err => Promise.reject(err));
      }
      return res.json();
    })
    .catch(err => console.error('请求错误:', err));
  

• 如果用Axios，它会自动将HTTP错误转为Promise拒绝，确保你的代码正确处理了catch块。

4. 可选：添加全局异常过滤器（兜底方案） #

如果需要统一处理所有异常（包括原生Error），可以创建全局过滤器确保所有异常都被标准化响应：

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

@Catch()
export class AllExceptionsFilter implements ExceptionFilter {
  catch(exception: unknown, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse<Response>();
    
    let status = 500;
    let message = 'Internal server error';

    if (exception instanceof HttpException) {
      status = exception.getStatus();
      message = exception.getResponse() as string;
    } else if (exception instanceof Error) {
      // 自定义原生Error的状态码映射
      if (exception.message === 'REG_QUE_LOCK_INACTIVITY') {
        status = 408;
      }
      message = exception.message;
    }

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

在AppModule中注册过滤器：

import { Module } from '@nestjs/common';
import { APP_FILTER } from '@nestjs/core';
import { AllExceptionsFilter } from './all-exceptions.filter';

@Module({
  providers: [
    {
      provide: APP_FILTER,
      useClass: AllExceptionsFilter,
    },
  ],
})
export class AppModule {}

验证流程 #

1. 先替换原生Error为Nest官方异常类，测试前端是否能收到408状态码。
2. 如果问题仍存在，排查unlockNewRegistrations方法的异常或响应干扰逻辑。
3. 最后确认前端的错误处理代码是否正确识别HTTP错误状态。

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