[Java] NullPointerException: 원인과 해결 방법

NullPointerException란?

NullPointerException(NPE)은 Java에서 발생하는 런타임 예외로, null 값 을 참조하여 객체처럼 사용하려고 할 때 발생합니다. 예를 들어, null 값에 대해 메서드를 호출하거나 필드에 접근하려는 경우가 이에 해당합니다.NullPointerException의 주요 발생 원인

1) 객체가 초기화되지 않은 상태에서 사용

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

2) 메서드 인자로 null이 전달됨

public void printName(String name) {
    System.out.println(name.toUpperCase());
}
printName(null); // NPE 발생

3) 컬렉션이 초기화되지 않음

List<String> list = null;
list.add("example"); // NPE 발생

4) Unboxing 시 null 값 처리

Integer num = null;
int value = num; // NPE 발생

---

NullPointerException을 해결하는 방법

1) null 체크 추가

• 값이 null인지 확인한 후 메서드를 호출합니다.

if (str != null) {
    System.out.println(str.length());
}

2) @NotNull 및 @Nullable 어노테이션 사용

• 코드 수준에서 null 가능성을 명시적으로 관리합니다.

public void printName(@NotNull String name) {
    System.out.println(name.toUpperCase());
}

3) Optional 활용

• Java 8 이상에서는 Optional 클래스를 사용해 null 처리를 보다 안전하게 관리합니다.

Optional<String> optional = Optional.ofNullable(null);
optional.ifPresent(value -> System.out.println(value.length()));

---

NPE 디버깅 팁

1. 스택 트레이스를 분석
   NPE가 발생한 라인을 확인하고, 어떤 값이 null인지 파악합니다.

Exception in thread "main" java.lang.NullPointerException
    at Example.main(Example.java:10)

2. 디버거 사용
   IDE의 디버거를 통해 null 값이 어디서 발생했는지 추적합니다.

---

예방을 위한 최고의 방법

• 항상 객체를 초기화한 후 사용하세요.
• 메서드에서 가능한 null 대신 빈 컬렉션 이나 기본값을 반환하세요.
• equals 호출 시 상수를 먼저 사용하세요.

if ("example".equals(str)) { ... }

• null-safe 라이브러리 메서드 사용: StringUtils.isEmpty(str) 등.

---

결론

NullPointerException은 Java 개발자에게 매우 흔한 문제지만, null 체크, 디버깅, 그리고 안전한 코딩 습관을 통해 쉽게 예방할 수 있습니다. 위 방법을 참고하여 오류를 미리 방지하고, 발생 시 빠르게 해결해 보세요.