⚠️ 07. 에러 처리 — 고객에게 친절한 '불만 처리 전담반' 만들기

import { NotFoundException, BadRequestException, ConflictException } from '@nestjs/common';
 
@Injectable()
export class UsersService {
  async getProfile(id: string) {
    const user = await this.db.findById(id);
 
    // 유저가 없다면 필터에게 위험 요소(예외)을 던짐!
    if (!user) {
      // 404 상태코드와 메시지가 담긴 예외 발생
      throw new NotFoundException(`회원번호 ${id}를 찾을 수 없습니다.`);
    }
    return user;
  }
}

// common/exceptions/business.exception.ts
export class InsufficientBalanceException extends BadRequestException {
  constructor(required: number, current: number) {
    // 프론트엔드에게 줄 JSON 데이터를 상세하게 마음대로 조립!
    super({
      errorCode: 'INSUFFICIENT_BALANCE',
      message: '돈이 부족합니다 .',
      details: { required, current } // 남은 잔액을 알려줌
    });
  }
}

// common/filters/http-exception.filter.ts
import { ExceptionFilter, Catch, ArgumentsHost, HttpException, HttpStatus } from '@nestjs/common';
import { Response } from 'express'; // Fastify 쓰면 FastifyReply 적용
 
@Catch() // 👈 아무 괄호도 안 적으면 '에러나는 모든 것'을 다 잡아채겠다는 뜻!
export class GlobalExceptionFilter implements ExceptionFilter {
 
  // 에러가 트리거되는 순간 여기가 반드시 실행됨
  catch(exception: unknown, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse<Response>();
    const request = ctx.getRequest<Request>();
 
    // 1. 상태 코드 판별 (내가 던진 에러면 그 코드, 아니면 반드시 500 처리)
    const status =
      exception instanceof HttpException
        ? exception.getStatus()
        : HttpStatus.INTERNAL_SERVER_ERROR;
 
    // 2. 최종 프론트엔드에게 내려갈 통일된 JSON 포맷!
    response.status(status).json({
      success: false,   // 반드시 들어가는 공통 상태
      timestamp: new Date().toISOString(),
      path: request.url,
 
      // 내가 던진 에러라면 알맹이를 빼오고, 알 수 없는 에러면 임의 메세지
      error: exception instanceof HttpException
        ? exception.getResponse()
        : '앗! 서버 내부 네트워크망 오류입니다!',
    });
  }
}

// main.ts
async function bootstrap() {
  const app = await NestFactory.create(AppModule);
 
  // 글로벌 필터 장착! 이제 365일 에러 안 놓침.
  app.useGlobalFilters(new GlobalExceptionFilter());
 
  await app.listen(3000);
}

import { ExceptionFilter, Catch, ArgumentsHost, HttpException, HttpStatus, Logger } from '@nestjs/common';
import { HttpAdapterHost } from '@nestjs/core';
import { ZodError } from 'zod'; // Zod 쓸 때
 
@Catch()
export class MegaGlobalFilter implements ExceptionFilter {
  // 로거 장착
  private readonly logger = new Logger(MegaGlobalFilter.name);
 
  // HttpAdapterHost를 쓰면 Express든 Fastify든 프레임워크 종속성 없이 응답(Reply) 가능!
  constructor(private readonly httpAdapterHost: HttpAdapterHost) {}
 
  catch(exception: unknown, host: ArgumentsHost) {
    const { httpAdapter } = this.httpAdapterHost;
    const ctx = host.switchToHttp();
    const request = ctx.getRequest();
 
    let status = HttpStatus.INTERNAL_SERVER_ERROR;
    let message = '알 수 없는 에러가 발생했습니다.';
    let errorCode = 'UNKNOWN_ERROR';
 
    // 분기 1: 내가 알고 던진 HTTP 에러 (400, 401, 404 등)
    if (exception instanceof HttpException) {
      status = exception.getStatus();
      const res = exception.getResponse() as any;
      message = typeof res === 'string' ? res : (res.message || 'Error');
      errorCode = res.errorCode || 'HTTP_ERROR';
    }
    // 분기 2: Zod 스키마 검증 실패 에러
    else if (exception instanceof ZodError) {
      status = HttpStatus.BAD_REQUEST;
      message = '입력값이 올바르지 않습니다.';
      errorCode = 'ZOD_VALIDATION_ERROR';
    }
    // 분기 3: 진짜 서버가 발생하는 버그 (null.abc 접근, DB 접속 지연 등) => 500
    else {
      // 🚨 치명적 에러는 반드시 자세하게 로깅! (또는 여기서 슬랙 API 호출)
      this.logger.error(
        `[${request.method}] ${request.url} - ${exception}`,
        (exception as Error)?.stack,
      );
    }
 
    // 통일된 응답 규격
    const responseBody = {
      statusCode: status,
      errorCode,
      message,
      timestamp: new Date().toISOString(),
      path: httpAdapter.getRequestUrl(request),
    };
 
    httpAdapter.reply(ctx.getResponse(), responseBody, status);
  }
}

// main.ts
const httpAdapterHost = app.get(HttpAdapterHost); // 어댑터 가져오기!
app.useGlobalFilters(new MegaGlobalFilter(httpAdapterHost));

// common/error-codes.ts
export const ErrorCodes = {
  USER_NOT_FOUND: 'USER_NOT_FOUND',
  EMAIL_EXISTS: 'EMAIL_EXISTS',
  TOKEN_EXPIRED: 'TOKEN_EXPIRED',
} as const;
 
// 사용할 때
throw new BadRequestException({ errorCode: ErrorCodes.EMAIL_EXISTS });

@Catch()
export class HttpFilter implements ExceptionFilter {
  constructor(private readonly httpAdapterHost: HttpAdapterHost) {}
}