Redis SCAN으로 센 키가 중복되면 버그인가요?
SCAN은 점진 순회이며 모든 호출을 합쳤을 때 중복이 없다고 보장하지 않습니다. 반환 개수를 단순 합산하면 고유 키 수와 달라질 수 있습니다. 순회 중 자료가 바뀌는 경우의 보장도 따로 읽어야 합니다.

- SCAN 반복에서는 같은 요소가 다시 나올 수 있습니다
- 커서와 처리 중복을 애플리케이션에서 관리합니다
- 운영 조회의 부하와 일관성 요구를 구분합니다
SCAN 반복에서는 같은 요소가 다시 나올 수 있습니다
SCAN은 점진 순회이며 모든 호출을 합쳤을 때 중복이 없다고 보장하지 않습니다. 반환 개수를 단순 합산하면 고유 키 수와 달라질 수 있습니다. 순회 중 자료가 바뀌는 경우의 보장도 따로 읽어야 합니다.
커서와 처리 중복을 애플리케이션에서 관리합니다
커서를 이어가며 완료 조건을 확인하고 고유 개수가 필요하면 중복 제거 방식을 준비합니다. 키에 작업을 적용한다면 같은 요소에 두 번 적용해도 안전한지 검토합니다. COUNT를 정확한 반환 개수 보장으로 생각하지 않습니다.
운영 조회의 부하와 일관성 요구를 구분합니다
큰 데이터에서 편리하다고 KEYS 전체 조회로 바꾸면 응답을 막을 수 있습니다. 필요한 것은 대략 현황인지 특정 시점의 정확한 수인지 먼저 정합니다. 시험 데이터로 순회와 중복 처리를 검증한 뒤 운영 범위를 정합니다.
서버 운영 실행 전 점검표
- SCAN 반복에서는 같은 요소가 다시 나올 수 있습니다
- 커서와 처리 중복을 애플리케이션에서 관리합니다
- 운영 조회의 부하와 일관성 요구를 구분합니다
이 가이드의 근거 문서
출처 확인일: 2026-11-04. 공식 문서에 기반한 편집 가이드이며 직접 수행한 벤치마크가 아닙니다. 비용 사례는 명시된 가정에 한합니다.
오류 제보 방법