chanYongYong

UUID란? 본문

개발/Database

UUID란?

chanYongYong 2026. 1. 26. 02:06

최근 엔티티 설계 중 PK값을 UUID로 필드를 구성하게 되었다.

그냥 Int나 Long을 사용하면 되는거 아닌가?

그 이유에 대해 작성해보겠다.


UUID란

128비트 길이의 고유 식별자로, 충돌없이 생성 가능한 ID다. 총 36자리 문자열로 표현된다.

인스턴스를 식별하기 위한 키로 정수값, UUID를 사용하는데,

상황에 따라 각각 쓰이거나 둘다 쓰이며,

실무에서는 정수와 UUID를 함께 쓴다.

users
-------------------------
id    BIGINT PK          -- 내부용
uuid  CHAR(36) UNIQUE    -- 외부 노출용

UUID를 PK로 쓰면?

  • 랜덤 값이라 인덱스 분산됨
  • 페이지 스플릿 증가
  • 대용량 데이터에서 성능 저하

따라서 현업에서는 PK로는 사용하지 않는다

 

그럼에도 PK를 UUID로 쓰는 경우는 언제임?

1. DB하나 뿐, 조인 거의 없음

2. 데이터 양이 많지 않음

3. 분산 시스템 단순 구조

4. NoSQL 이벤트 기반 시스템


UUID 사용 이유

1. 외부 노출 시에 사용하면 추측 불가.

GET /users/1        ❌ 하지 않는 것
GET /users/{uuid}   ⭕ 항상 이렇게

/users/1, /users/2처럼 순차적 ID를 노출하면 공격자가 1부터 하나씩 요청을 날려볼 수 있다.

이를 ID 열거(Enumeration) 공격이라고 한다.

 

"어차피 권한 체크하면 되는 거 아닌가?"라고 생각할 수 있다. 맞다.

하지만 현실에서는 빠진 권한 체크, 임시 API, 테스트용 코드, 레거시 코드 등 구멍이 생기기 마련이다.

 

UUID는 2차 안전장치 역할을 한다. 보안에서는 이를 **Defense in Depth(다층 방어)**라고 부른다.

무작위 대입(brute force)이 사실상 불가능해진다.

 

게임 쿠폰 코드를 떠올리면 이해가 쉽다. (필자도.... 어렸을 적 많은 시도를 해보았지만 쿠폰을 얻을 수 없었다)

 

(조회 성능이 걱정된다면, UUID 컬럼에 유니크 인덱스를 걸면 됨)

(검색 속도 안 느림. UUID에도 인덱스가 있음)

CREATE UNIQUE INDEX idx_users_uuid ON users(uuid);

2. DB 저장 전에 ID가 필요한 경우

게시글 작성으로 예를 들어보자. 사용자가 게시글을 올리기 전에 이미지를 먼저 업로드한다.

이 이미지들을 "아직 DB에 저장되지 않은 게시글"과 연결해야 한다.

 

이때 클라이언트에서 UUID를 미리 생성해서 게시글과 이미지에 동일한 UUID를 부여하면,

DB 저장 전에도 관계를 정의할 수 있다.

 

이커머스 서비스도 마찬가지다.

주문 생성 → 결제 처리 → 배송 처리가 서로 다른 서비스에서 이뤄질 때, 동일한 UUID로 같은 주문임을 식별한다.


3. 여러 서버에서 독립적으로 ID 생성

Long ID는 중앙에서 순차 발급해야 충돌이 없다.

 

서버가 여러 대일 때 범위를 나누는 방식(서버A: 1~100만, 서버B: 100만~200만)도 가능하지만, 다음 문제가 생긴다

  • 서버 추가 시 범위 분배 난감
  • 서버 교체/재배치 시 ID 범위 이어받기 문제
  • 롤백 시 중복 발생 가능성
  • 트래픽 불균형으로 특정 서버만 범위 소진

UUID는 중앙 ID 발급 없이도 여러 서버나 클라이언트에서 독립적으로 생성할 수 있어,

분산 환경에서 동일한 객체를 충돌 없이 식별할 수 있기 때문에 사용한다.


4. 데이터 병합 가능

서로 다른 서버/DB의 데이터를 병합할 때, Long ID는 둘 다 1번부터 시작했으므로 충돌한다.

UUID는 전 세계적으로 고유하므로 병합 시 충돌이 없다.

Long을 PK로 유지하고, UUID로 매칭 → Long을 재정렬하는 방식을 사용한다.


정리

실무에서는 Long을 기본키로 사용하되, 외부 API나 URL에는 UUID만 노출한다.  

UUID 컬럼에는 유니크 인덱스를 걸어 조회 성능 문제 없다.

 Long PK는 내부 조인과 성능 최적화를 위해서 사용한다.

외부에서는 ID Enumeration 공격이 어려워진다.