Spring Boot Actuator Heapdump로 힙 메모리 분석해보기

Yoon Soojeong·2025년 12월 2일

오늘은 운영 환경에서 자주 쓰이는 메모리 진단 흐름을 직접 따라 해보면서, 일부러 TroubleMaker
Controller 클래스로 장애를 만들고 -> Spring Boot의 heapdump 엔드포인트를 열고 -> Docker 이미지 재빌드 -> heapdump(hprof) 파일 다운로드 -> IntelliJ로 분석하는 과정을 전부 경험했다.

중간중간 생소했던 부분도 있었지만, 직접 해보니 이런 식으로 서비스 메모리를 들여다볼수있음을 깨닫게 되었다.

00. Heapdump란?

JVM이 실행 중일 때, 힙 메모리의 전체 스냅샷을 그대로 떠서 파일로 저장한 것.
다시 말해, 지금 이 순간, 내 자바 프로그램이 메모리를 어떻게 쓰고 있는지 그대로 찍은 X-ray 사진과 같다.

쉬운 비유!
JVM = 큰 방
Heap = 방 안의 책상들
객체 = 책상 위에 놓인 물건들
Garbage Colletor = 정리하는 로봇
Heapdump = 방 안을 사진으로 그대로 찍어놓은 것

01. TroubleMakerController 작성

@RestController
public class TroubleMakerController {
    //메모리 누수 용도 (static -> GC가 없애지 못함)
    private static final List<byte[]> LEAK_LIST = new ArrayList<>();

    @GetMapping("/leak")
    public String leak() {
        LEAK_LIST.add(new byte[10*1024*1024]); //한번 호출 될때 10MB씩 공간 차지
        return "Memory leakㅠㅠ current size: " + LEAK_LIST.size();
    }

    @GetMapping("/slow")
    public String slow() throws  InterruptedException {
        Thread.sleep(5000);
        return "I am slow";
    }
}

메모리 누수 용도의 leak()와 일부러 느린 API를 만들기 위한 slow()를 작성하였다.

02. actuator heapdump 엔드포인트 열기

application.yml에 heapdump가 노출되도록 설정해야 한다.

management:
  endpoints:
    web:
      exposure:
        include:
          - health
          - info
          - metrics
          - loggers
          - threaddump
          - prometheus
          - heapdump

이렇게 저장하면 /actuator/heapdump로 접속했을 때 heapdump 파일을 받을 수 있게 된다.

03. Docker 이미지 재빌드

프로젝트 설정이 바뀌었기 때문에 이미지도 다시 빌드했다.

docker build -t my-spring-app:1.0 . #재빌드
docker stop api1 #현재 api1 컨테이너 중지
docker rm api1 #삭제
docker run -d --name api1 -p 8081:8080 my-spring-app:1.0 #실행

이 과정은 외울 수 있을 정도로 많이 숙련되면 좋을 것 같다.