Throwable
├─ Error (잡지 않음, 복구 불가)
│   ├─ OutOfMemoryError
│   └─ StackOverflowError
└─ Exception
    ├─ checked (컴파일러가 처리 강제)
    │   ├─ IOException
    │   └─ SQLException
    └─ RuntimeException (unchecked)
        ├─ NullPointerException
        ├─ IllegalArgumentException
        ├─ IllegalStateException
        ├─ IndexOutOfBoundsException
        ├─ ClassCastException
        ├─ NumberFormatException (IllegalArgumentException 하위)
        ├─ UnsupportedOperationException
        ├─ ConcurrentModificationException
        └─ ArithmeticException

try {
    process();
} catch (IllegalArgumentException e) {   // 구체적
    log.warn("잘못된 인자", e);
} catch (RuntimeException e) {           // 일반적, 뒤에
    log.error("처리 실패", e);
}
// → 순서 반대면 컴파일 에러(이미 잡힌 catch 이후 도달 불가)

try {
    convert();
} catch (NumberFormatException | DateTimeParseException e) {
    log.warn("입력 형식 오류: {}", e.getMessage());
}

static int bad() {
    try {
        return 1;
    } finally {
        return 2;   // → 항상 2 반환, try의 1은 버려짐. 절대 금지
    }
}

try (var a = openA(); var b = openB()) {
    use(a, b);
}
// → 닫는 순서: b.close() 먼저, a.close() 나중
// b.close()에서 예외가 나면 a.close()의 예외는 suppressed로 붙는다

try {
    /* 위 코드에서 예외 발생 시 */
} catch (Exception e) {
    for (var s : e.getSuppressed()) log.warn("suppressed: {}", s.toString());
}

void save(String id) throws SQLException {   // 선언: 호출자에게 알림
    if (id == null) throw new IllegalArgumentException("id null");  // 실행
}

try {
    repo.save(entity);
} catch (SQLException e) {
    throw new IllegalStateException("저장 실패: id=" + entity.getId(), e);
    // → 두 번째 인자 e가 원인(cause) 보존. 빠뜨리면 원인 추적 불가
}

try {
    return mapper.selectUser(id);
} catch (PersistenceException e) {
    throw new UserNotFoundException("user id=" + id, e);   // 예외 번역
}

throw new IllegalArgumentException("orderId=" + orderId + " status=" + status + " 는 취소 불가");

public enum ErrorCode {
    USER_NOT_FOUND(404, "사용자를 찾을 수 없습니다"),
    DUPLICATE_EMAIL(409, "이미 등록된 이메일입니다"),
    INVALID_STATE(400, "잘못된 상태입니다");

    final int httpStatus;
    final String message;
    ErrorCode(int httpStatus, String message) {
        this.httpStatus = httpStatus;
        this.message = message;
    }
}

public class BusinessException extends RuntimeException {
    private final ErrorCode errorCode;
    private final String detail;

    public BusinessException(ErrorCode c) { this(c, null, null); }
    public BusinessException(ErrorCode c, String detail) { this(c, detail, null); }
    public BusinessException(ErrorCode c, Throwable cause) { this(c, null, cause); }
    public BusinessException(ErrorCode c, String detail, Throwable cause) {
        super(c.message + (detail != null ? " (" + detail + ")" : ""), cause);
        this.errorCode = c;
        this.detail = detail;
    }
    public ErrorCode getErrorCode() { return errorCode; }
}
// → throw new BusinessException(ErrorCode.USER_NOT_FOUND, "id=" + id);

java.lang.IllegalStateException: 주문 처리 실패: orderId=1001
    at com.company.order.OrderService.process(OrderService.java:42)
    at com.company.order.OrderController.create(OrderController.java:20)
    at jdk.internal.reflect.GeneratedMethodAccessor12.invoke(Unknown Source)
    at java.base/java.lang.reflect.Method.invoke(Method.java:568)
Caused by: java.sql.SQLException: ORA-00001: unique constraint violated
    at com.company.order.OrderMapper.insert(OrderMapper.java:15)
    at com.company.order.OrderService.process(OrderService.java:40)
    ... 23 more

log.error("주문 처리 실패: orderId={}", orderId, e);   // e를 마지막 인자로

Cannot invoke "String.length()" because "s" is null

new BigDecimal("10").divide(new BigDecimal("3"));
// → ArithmeticException: Non-terminating decimal expansion
new BigDecimal("10").divide(new BigDecimal("3"), 2, RoundingMode.HALF_UP);
// → 3.33

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(BusinessException.class)
    public ResponseEntity<ErrorResponse> handle(BusinessException e) {
        var code = e.getErrorCode();
        return ResponseEntity.status(code.httpStatus)
                .body(new ErrorResponse(code.name(), e.getMessage()));
    }

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ErrorResponse> handle(MethodArgumentNotValidException e) {
        var msg = e.getBindingResult().getFieldErrors().get(0).getDefaultMessage();
        return ResponseEntity.badRequest().body(new ErrorResponse("VALIDATION", msg));
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handle(Exception e) {
        String traceId = MDC.get("traceId");
        log.error("처리되지 않은 예외 traceId={}", traceId, e);
        return ResponseEntity.internalServerError()
                .body(new ErrorResponse("INTERNAL", "서버 오류, traceId=" + traceId));
    }
}

@Transactional(rollbackFor = Exception.class)
void transfer(...) throws Exception { ... }

@Transactional
void bad() {
    try {
        repo.save(entity);
    } catch (Exception e) {
        log.warn("저장 실패", e);   // → 삼켜짐, 트랜잭션은 그대로 커밋된다
    }
}
// 반드시 다시 던지거나 setRollbackOnly() 호출

try {
    mapper.insert(user);
} catch (DuplicateKeyException e) {   // ORA-00001이 여기로 매핑
    throw new BusinessException(ErrorCode.DUPLICATE_EMAIL, e);
}

Objects.requireNonNull(id, "id must not be null");
// → null이면 NullPointerException: id must not be null

String name = Objects.requireNonNullElse(input, "default");
// → input이 null이면 "default"

Optional<User> opt = repo.findById(id);
opt.orElse(guestUser);                              // 기본값(즉시 계산됨)
opt.orElseGet(() -> buildGuestUser());               // 기본값(지연 계산)
opt.orElseThrow(() -> new UserNotFoundException(id));// 없으면 예외

Evaluate: list.stream().filter(x -> x.getId() == 42).count()

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar app.jar

log.debug("조회 시작 userId={}", userId);
var user = repo.findById(userId).orElseThrow();
log.debug("조회 완료 status={}", user.getStatus());

log.info("주문 생성 orderId={} amount={}", orderId, amount);   // 문자열 연결 금지

MDC.put("traceId", UUID.randomUUID().toString());
// ... 요청 처리 ...
MDC.clear();   // 스레드 재사용 대비 필수

C:\project\jdk-21.0.8\bin\jstack 12345 > thread_dump.txt

Found one Java-level deadlock:
"Thread-1": waiting to lock monitor 0x000... (a java.lang.Object),
  which is held by "Thread-0"

-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=C:\dumps
# → OOM 발생 시 자동으로 힙 덤프 생성

-Xlog:gc*:file=gc.log
# → GC 로그를 파일로 기록

-XX:+ExitOnOutOfMemoryError
# → OOM 시 프로세스 즉시 종료(재기동 스크립트와 병행)

-Dfile.encoding=UTF-8
# → 파일/콘솔 인코딩 고정, 폐쇄망 한글 깨짐 방지

-ea
# → assert 문 활성화(기본은 비활성)

-verbose:class
# → 클래스 로딩 과정 출력, 클래스 충돌 진단

-XX:+PrintFlagsFinal
# → 전체 JVM 옵션 값 출력, grep으로 필터링

C:\project\jdk-21.0.8\bin\java -XX:+PrintFlagsFinal -version | grep -i heapsize

@Test
void 존재하지않는사용자조회시예외() {
    assertThrows(UserNotFoundException.class, () -> service.getUser(-1L));
}

@ParameterizedTest
@ValueSource(strings = {"", " ", "abc"})
void 잘못된형식이면예외(String input) {
    assertThrows(NumberFormatException.class, () -> Integer.parseInt(input.trim()));
}