UUID 사용 베스트 프랙티스
실무에서 UUID를 다룰 때 지키면 좋은 원칙을 체크리스트로 정리합니다.
버전 선택
특별한 이유가 없으면 범용에는 v4, 데이터베이스 기본키처럼 정렬이 중요하면 v7을 쓰세요. 이름 기반의 재현 가능한 ID가 필요할 때만 v3·v5를 고려합니다.
일관된 형식
한 시스템 안에서는 대소문자·하이픈 형식을 하나로 통일하세요. 소문자·하이픈 포함이 가장 흔한 표준이며, 저장·비교·로그의 혼선을 줄여줍니다.
보안 분리
UUID는 유일 식별자일 뿐 비밀이 아닙니다. 세션·비밀번호 재설정 토큰 등 추측이 곤란해야 하는 값에는 UUID 대신 전용 보안 토큰을 쓰고, 항상 암호학적 난수원으로 생성하세요.
검증
외부에서 받은 UUID는 형식·버전을 검증한 뒤 사용하세요. 인스펙터로 버전과 변형을 확인하면 잘못된 입력이나 예상과 다른 버전을 빠르게 걸러낼 수 있습니다.