← Projects

Performance Optimization

N+1 쿼리 제거를 통한 서비스 담당자 조회 API 성능 개선

서비스 유저 목록 1회와 상세·등록자 정보 일괄 조회 각 1회로 반복 조회를 제거해, 운영 데이터 68명 조회에서 SQL 약 200회 → 3회, API 응답 시간 3초 이상 → 1초 미만으로 개선

Company
N Tech Service
Period
2026.03
  • Java
  • Spring Boot
  • jOOQ
  • MySQL

서비스 담당자 조회 API에서 유저마다 상세정보와 등록자를 조회하던 흐름을 일괄 조회로 바꾸고, 응답 데이터는 사번을 키로 한 HashMap에서 조합했다.

문제와 원인

DB 계정 작업 요청 티켓에서 패스워드 확인 버튼이 늦게 노출된다는 제보를 계기로 서비스 담당자 조회 API의 지연을 확인했다. 당시 운영 데이터 68명을 조회했을 때 응답에 3초 이상 걸리고 SQL이 약 200회 실행되는 것을 확인했다.

기존 코드는 서비스 유저 목록을 조회한 다음 Java for 문에서 각 유저의 상세정보(이름·부서)와 등록자 정보를 jOOQ Repository Query로 조회했다. 이는 ORM의 지연 로딩이 아니라 애플리케이션 코드가 반복문 안에서 조회 Query를 호출해 발생한 N+1 형태의 문제다.

서비스 유저 목록 조회
  → 유저별 상세정보 조회
  → 유저별 등록자 정보 조회
  → 다음 유저에서 두 조회 반복

위 흐름의 조회만 계산하면 68명에 대해 **137회(1 + 68 × 2)**다. 실제 확인한 약 200회와 차이가 있지만 SQL 집계 범위와 차이의 원인은 확인되지 않았다.

일괄 조회와 데이터 조합

서비스 유저 목록, 유저 상세정보, 등록자 상세정보를 각각 한 번씩 조회하도록 바꿨다. 조회한 상세정보와 등록자 정보는 사번을 키로 하는 HashMap에 담고, 서비스 유저를 순회하면서 Map에서 찾아 응답을 구성했다.

기존: 서비스 유저 목록 조회 → 유저별 상세정보·등록자 정보 반복 조회

개선: 서비스 유저 목록 조회 (1회)
      + 유저 상세정보 일괄 조회 (1회)
      + 등록자 상세정보 일괄 조회 (1회)
      → 사번 기준 HashMap 조합 → 응답

개선한 조회 흐름에서는 유저별 반복문 안에서 추가 SQL을 실행하지 않는다. 따라서 이 흐름의 조회 횟수는 유저 수에 비례해 늘어나지 않는다.

JOIN 1회 조회 대신 일괄 조회를 선택한 이유

JOIN으로 필요한 데이터를 한 Query에서 가져오는 방안도 검토했다. 기존 Repository Query를 일괄 호출하는 방식으로 유저 수에 비례하는 반복 조회를 없앨 수 있어 API 전용 JOIN Query를 추가하지 않았다. 이 선택에는 세 번의 DB 조회와 Java에서의 Map 조합이 따른다.

결과

운영 데이터 68명 조회 기존 개선 후
SQL 실행 횟수 약 200회 3회
API 응답 시간 3초 이상 1초 미만

위 수치는 운영 환경에서 68명을 조회했을 때 확인한 전후 값이다. 다른 조회 규모에서의 응답 시간이나 각 변경 요소의 개별 기여도까지 나타내지는 않는다.

QUERY FLOW · 8명 예시

반복 조회 → 3회 일괄 조회와 HashMap 조합

01 / 14
BEFORE · for 안에서 SQL 실행예시 17회 SQL
DB → 서비스 유저 목록 SELECT × 1
101등록자 901102등록자 902103등록자 901104등록자 903105등록자 901106등록자 902107등록자 903108등록자 901
for (서비스 유저)반복문 내부 DB 접근
1번째유저 101
SQL상세 101
SQL등록자 901
2번째유저 102
SQL상세 102
SQL등록자 902
3번째유저 103
SQL상세 103
SQL등록자 901재조회
4번째유저 104
SQL상세 104
SQL등록자 903
5번째유저 105
SQL상세 105
SQL등록자 901재조회
6번째유저 106
SQL상세 106
SQL등록자 902재조회
7번째유저 107
SQL상세 107
SQL등록자 903재조회
8번째유저 108
SQL상세 108
SQL등록자 901재조회
예시 8명: 목록 1회 + 반복 조회 16회 총 17회 SQL
AFTER · 먼저 일괄 조회총 3회 SQL
DB → 필요한 데이터를 한 번씩 조회
SQL ①서비스 유저 목록101–108 · 8명
SQL ②유저 상세 전체101–108 · 8건
SQL ③등록자 상세 전체901 · 902 · 903
HashMap · key = 유저 사번101 · 102 · 103 · 104 · 105 · 106 · 107 · 108
HashMap · key = 등록자 사번901 · 902 · 903
for (서비스 유저)Map 조회 → 응답 설정
101상세[101] + 등록자[901]
102상세[102] + 등록자[902]
103상세[103] + 등록자[901]재사용
104상세[104] + 등록자[903]
105상세[105] + 등록자[901]재사용
106상세[106] + 등록자[902]재사용
107상세[107] + 등록자[903]재사용
108상세[108] + 등록자[901]재사용
반복문 안 추가 SQL 0회

① 서비스 유저 목록을 한 번 조회해 사번과 등록자 사번을 가져옵니다.

사번과 8명은 동작을 설명하기 위한 예시입니다. 운영 데이터 68명 조회에서 SQL 약 200회 → 3회, API 응답 시간 3초 이상 → 1초 미만을 확인했습니다. 약 200회의 집계 기준은 확인되지 않았습니다.