자바 메모리 누수 패턴 — ThreadLocal, Listener, 내부 클래스 함정

// 위험한 코드
public class UserContext {
    private static final ThreadLocal<User> currentUser = new ThreadLocal<>();

    public static void set(User user) { currentUser.set(user); }
    public static User get() { return currentUser.get(); }
    // remove()를 호출하지 않으면?
}

// 해결: finally에서 반드시 remove()
public class ThreadLocalFilter implements Filter {
    @Override
    public void doFilter(ServletRequest req, ServletResponse res,
                         FilterChain chain) throws Exception {
        try {
            UserContext.set(extractUser(req));
            chain.doFilter(req, res);
        } finally {
            UserContext.remove(); // 반드시 정리!
        }
    }
}

// 위험한 코드
public class DashboardPanel {
    public DashboardPanel(EventBus eventBus) {
        // 리스너 등록 — DashboardPanel 인스턴스에 대한 참조가 EventBus에 남음
        eventBus.register(this::onDataUpdate);
    }
    // DashboardPanel이 화면에서 사라져도 EventBus가 참조를 들고 있음 → GC 불가
}

// 해결: 해제 메서드 제공
public class DashboardPanel implements AutoCloseable {
    private final Disposable subscription;

    public DashboardPanel(EventBus eventBus) {
        this.subscription = eventBus.register(this::onDataUpdate);
    }

    @Override
    public void close() {
        subscription.dispose(); // 리스너 해제
    }
}

// 위험한 코드
public class DataProcessor {
    private byte[] largeData = new byte[10_000_000]; // 10MB

    public Runnable createTask() {
        // 비정적 내부 클래스 → DataProcessor 참조를 들고 있음
        return new Runnable() {
            @Override
            public void run() {
                System.out.println("작업 실행");
                // largeData를 사용하지 않지만 참조는 남아있음
            }
        };
    }
}

// DataProcessor를 null로 해도, Runnable이 살아있으면 GC 불가

// 해결: static 내부 클래스 또는 람다 사용
public class DataProcessor {
    private byte[] largeData = new byte[10_000_000];

    public Runnable createTask() {
        // 람다는 캡처한 변수만 참조 (외부 클래스 전체를 참조하지 않음)
        return () -> System.out.println("작업 실행");
    }

    // 또는 static 내부 클래스
    private static class Task implements Runnable {
        @Override
        public void run() { System.out.println("작업 실행"); }
    }
}

// 위험한 코드
private static final Map<String, Object> cache = new HashMap<>();

public Object getCached(String key) {
    return cache.computeIfAbsent(key, k -> expensiveCompute(k));
    // 캐시 항목이 영원히 쌓임 → 메모리 고갈
}

// 해결 1: 크기 제한 (LRU 캐시)
private static final Map<String, Object> cache =
    new LinkedHashMap<>(100, 0.75f, true) {
        @Override
        protected boolean removeEldestEntry(Map.Entry<String, Object> eldest) {
            return size() > 1000; // 1000개 초과 시 가장 오래된 항목 제거
        }
    };

// 해결 2: WeakHashMap (키가 GC되면 자동 제거)
private static final Map<Object, String> cache = new WeakHashMap<>();

// 해결 3: Caffeine 캐시 라이브러리
Cache<String, Object> cache = Caffeine.newBuilder()
    .maximumSize(1000)
    .expireAfterWrite(Duration.ofMinutes(10))
    .build();

// 위험한 코드
public class TaskQueue {
    private final List<Task> completedTasks = new ArrayList<>();

    public void complete(Task task) {
        task.markDone();
        completedTasks.add(task); // 계속 쌓임
        // 어디서도 completedTasks를 비우지 않음
    }
}

// 위험한 코드
for (String line : readLargeFile()) {
    // intern()은 문자열을 String Pool(PermGen/Metaspace)에 저장
    processedData.add(line.intern()); // 수백만 문자열이 해제 불가
}

# 힙 덤프 생성
jmap -dump:live,format=b,file=heap.hprof <PID>

# OOM 시 자동 덤프
java -XX:+HeapDumpOnOutOfMemoryError \
     -XX:HeapDumpPath=/tmp/heapdump.hprof \
     -jar app.jar