NestJS中间件错误未被异常过滤器捕获致客户端连接失败求助

行为确认 #

这个现象是正常的，核心原因有两点：

• NestJS的应用级异常过滤器默认仅捕获路由处理函数、守卫、拦截器、管道抛出的错误，中间件属于请求生命周期更早的阶段，且基于底层HTTP框架（Express/Koa）的机制运行，普通异常过滤器无法直接捕获中间件中未正确传递的错误。
• 你的代码中this.modify(request)返回的Promise如果抛出错误，会变成未处理的Promise拒绝，Node.js会将这类错误视为致命错误，直接终止当前请求的处理流程，导致客户端无法收到响应，表现为请求被拒绝。

解决方案 #

1. 捕获异步错误并传递给Nest错误处理管道 #

修改中间件代码，确保所有异步操作的错误都被捕获，并通过next(error)传递给Nest的错误处理机制：

@Injectable()
export class FirebaseMiddleware implements NestMiddleware {
  constructor(private readonly firebaseService: FirebaseService) {}

  use(request: Request, response: Response, next: NextFunction) {
    this.modify(request)
      .then(next)
      .catch((error) => {
        // 将错误传递给Nest的错误处理流程
        next(error);
      });
  }
}

这样处理后，错误会被底层HTTP框架的错误处理机制接收，进而被Nest的全局异常过滤器捕获（前提是你的过滤器配置正确）。

2. 确保异常过滤器能处理中间件传递的错误 #

如果你的应用级异常过滤器是自定义的，需要确保它能识别并处理中间件传递过来的错误类型。比如在过滤器中针对Firebase相关错误做特殊处理：

@Catch()
export class AllExceptionsFilter implements ExceptionFilter {
  catch(exception: unknown, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse<Response>();
    const request = ctx.getRequest<Request>();

    // 处理Firebase认证类错误
    if (exception.name === 'FirebaseAuthError') {
      response.status(HttpStatus.UNAUTHORIZED).json({
        statusCode: HttpStatus.UNAUTHORIZED,
        timestamp: new Date().toISOString(),
        path: request.url,
        message: '身份认证失败',
      });
    } else {
      // 通用错误处理逻辑
      const status = exception instanceof HttpException 
        ? exception.getStatus() 
        : HttpStatus.INTERNAL_SERVER_ERROR;
      
      response.status(status).json({
        statusCode: status,
        timestamp: new Date().toISOString(),
        path: request.url,
        message: exception instanceof Error ? exception.message : '服务器内部错误',
      });
    }
  }
}

3. 同步错误的处理（如果存在） #

如果中间件中有同步代码抛出错误，直接抛出即可，Nest会自动捕获并传递给错误处理管道：

use(request: Request, response: Response, next: NextFunction) {
  if (!request.headers.authorization) {
    throw new UnauthorizedException('缺少认证请求头');
  }
  // 后续异步逻辑...
}

关键说明 #

NestJS的中间件本质是对Express/Koa中间件的封装，必须遵循底层框架的错误处理规则：所有错误必须通过next(error)传递，否则会触发未处理的错误，直接中断请求流程。

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