자바(Spring) 기본 예외 처리

📌1.  try-catch 문과 throws Exception 사용법

기본적인 예외 처리는 다음 두 가지 방법으로 구현할 수 있다.

✅ 1-1. try-catch 문

try-catch 문은 코드 실행 중 발생하는 예외를 감지하고 처리하는 가장 일반적인 방식이다.

• 로직을 중단하지 않고 즉각적인 예외 처리.
• Spring MVC에서 주로 Controller

 

📖 try-catch 예시

try {
    int result = 10 / 0; // 예외 발생 (ArithmeticException)

} catch (ArithmeticException e) {
    System.out.println("예외 발생: " + e.getMessage()); // 예외 메시지 출력
    e.printStackTrace();  // 스택 트레이스 출력
    
} catch (NullPointerException | ArithmeticException e) { // 다중 catch 블록
   // …
} finally { // finally 블럭
    // 항상 실행되는 코드 (리소스 반환 등)
}

✅ 1-2.  throws Exception

throws 키워드는 메서드에서 발생할 수 있는 예외를 호출한 곳에서 처리하도록 위임하는 역할을 한다.

• 예외를 상위 메서드로 전파하여 깨끗한 코드 및 유연성 가짐(호출 부 마다 다르게 처리).
• Spring MVC에서 주로 Service

 

📖 throws Exception 예시

public void readFile(String fileName) throws IOException {
    FileReader file = new FileReader(fileName); // IOException 발생 가능
}

 

🔍만약 controller에서도 throws 하면?

Spring에서 처리한다!! -> 📌3번 참고!!

 

📌 2. 예외의 종류

자바에서 예외(Exception)는 프로그램 실행 중에 발생할 수 있는 오류 상황을 처리하기 위해 사용된다. 

✅ 2-1. Exception 계층 - exception에 안 걸리는 에러

외부 api 에러 중 Exception에 걸리지 않는 에러가 있었다!! 이때도 처리 방법을 찾다가 catch (Throwable t)를 사용하게 되어서 계층에 대해 알아보았다.

🔹 예외 계층 구조

• 자바의 예외는 Throwable 계층 구조를 따른다. Throwable 클래스는 최상위 클래스로, Error와 Exception을 포함한다.

java.lang.Throwable
 ├── Error (예: OutOfMemoryError)
 ├── Exception
      ├── 체크 예외 (Checked Exception): IOException, SQLException 등
      ├── 언체크 예외 (Unchecked Exception): RuntimeException, NullPointerException 등

 

🔹  Error와 Exception

• Error: 주로 시스템 수준에서 발생하는 문제(예: OutOfMemoryError, StackOverflowError 등)로, 복구가 불가능한 에러이다.
• Exception: 애플리케이션 수준에서 발생할 수 있는 예외이다. 이 클래스는 Throwable을 상속하며, 체크 예외(Checked Exception)와 언체크 예외(Unchecked Exception)로 나뉜다.

 

🔹 예외 처리

• 일반적으로 catch (Exception e)를 사용하여 애플리케이션에서 발생하는 예외를 처리하며,
• catch (Throwable t)를 사용하면 시스템 오류까지 포괄적으로 처리할 수 있다.
• 하지만 Error는 복구할 수 없는 시스템 오류이므로, 대부분의 경우 Exception만 처리하는 것이 바람직하다.

 

✅ 2-2. 체크 예외 vs 언체크 예외 - 왜 특정 에러만 컴파일 오류가 날까?

예외 처리를 하지 않았을 때 컴파일 오류가 나는 경우는 뭘까? -> 체크 예외!!

자바에서는 예외를 크게 체크 예외(Checked Exception) 와 언체크 예외(Unchecked Exception) 로 구분한다.

🔹 체크 예외 (Checked Exception)

• 컴파일 시점에 예외 처리를 강제하는 예외 (처리 안 하면 컴파일 에러 난다!)
• 반드시 try-catch로 처리하거나 throws로 위임해야 함
• 대표적인 예: IOException, SQLException, FileNotFoundException
• Exception 클래스 상속

try {
    FileReader file = new FileReader("test.txt");
} catch (FileNotFoundException e) {
    System.out.println("파일을 찾을 수 없습니다.");
}

 

🔹 언체크 예외 (Unchecked Exception)

• 실행(Runtime) 중 발생하는 예외로, 명시적인 예외 처리가 강제되지 않음
• 대표적인 예: NullPointerException, ArrayIndexOutOfBoundsException, ArithmeticException
• RuntimeException 클래스 상속

String str = null;
System.out.println(str.length()); // NullPointerException 발생

 

✅ 2-3. 주요 예외 종류

자주 발생하는 예외의 종류이다!

예외 클래스	설명
IOException	파일 입출력 과정에서 발생하는 예외
SQLException	데이터베이스 연산 중 발생하는 예외
NullPointerException	객체가 null일 때 메서드를 호출할 경우 발생
ArrayIndexOutOfBoundsException	배열의 유효 범위를 벗어난 경우 발생
ArithmeticException	0으로 나누는 연산을 수행할 때 발생

 

📌 3. 스프링에서의 예외 처리 흐름 - 만약 controller에서도 throws 하면?

1-3에서의 의문을 풀기위해 알아본 내용이다!!

✅ 3-1. 기본 예외 처리 방식 (DispatcherServlet의 역할)

스프링에서는 기본적으로 DispatcherServlet이 예외를 처리한다. 컨트롤러에서 예외가 발생하면 DispatcherServlet이 이를 감지하고 적절한 HTTP 응답을 반환한다.

• Exception 또는 RuntimeException이 발생하면 500 Internal Server Error를 반환
• 특정 예외에 대한 처리가 없으면 기본적인 예외 응답을 클라이언트에 전달

 

✅ 3-2. @ExceptionHandler와 @ControllerAdvice

스프링에서는 @ExceptionHandler와 @ControllerAdvice를 사용해 전역 또는 개별 컨트롤러 단위에서 예외를 처리할 수 있다.

 

📖 @ExceptionHandler (개별 컨트롤러에서 예외 처리)

@RestController
public class SampleController {
    @GetMapping("/divide")
    public int divide(@RequestParam int a, @RequestParam int b) {
        return a / b; // b가 0이면 ArithmeticException 발생
    }

    @ExceptionHandler(ArithmeticException.class)
    public ResponseEntity<String> handleArithmeticException(ArithmeticException e) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("잘못된 계산입니다: " + e.getMessage());
    }

}

 

📖 @ControllerAdvice (전역 예외 처리)

@ControllerAdvice를 사용하면 여러 컨트롤러에서 발생하는 예외를 한 곳에서 처리할 수 있다.

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(NullPointerException.class)
    public ResponseEntity<String> handleNullPointerException(NullPointerException e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Null 값이 발생했습니다");
    }
}