게임 세이브 데이터 마이그레이션 QA 가이드: 버전 업데이트 시 데이터 유실과 크래시를 방지하는 검증 전략

핵심 요약

게임 세이브 데이터 마이그레이션 QA의 핵심은 스키마 버전 체인 검증과 크로스 버전 매트릭스 테스트입니다. 버전 업데이트 시 발생하는 데이터 유실 및 역직렬화(Deserialization) 크래시를 막으려면 레거시 세이브 파일 아카이브를 구축하고 단계별 마이그레이터(Migrator)를 거치는 순차적 데이터 무결성 검증과 CI 기반 자동화 테스트를 병행해야 합니다.

세이브 데이터 마이그레이션 오류는 왜 발생하는가?

라이브 서비스 중인 게임이나 지속적인 콘텐츠 패치를 진행하는 패키지 게임에서 세이브 데이터 구조(Schema) 변경은 불가피합니다. 신규 캐릭터 추가, 인벤토리 구조 개편, 퀘스트 ID 체계 변경, 수치 밸런스 조정 등 다양한 이유로 세이브 파일의 포맷이 진화합니다.

이 과정에서 적절한 마이그레이션 처리가 이루어지지 않으면 다음과 같은 치명적인 문제가 발생합니다.

역직렬화 실패 및 크래시: 필드 타입이 변경되었거나(int에서 float 또는 string), 필수 필드가 삭제된 레거시 데이터를 새 클라이언트가 읽으려 할 때 NullReferenceException이나 파싱 에러로 게임이 강제 종료됩니다.
데이터 유실(Data Loss): 스키마가 변경되면서 이전 버전의 특정 아이템, 업적, 재화 정보가 새 구조에 매핑되지 않고 누락되는 현상입니다.
점프 업데이트(Jump Update) 실패: $v1.0$ 에서 바로 $v1.1$ 로 업데이트한 유저는 정상이지만 장기간 접속하지 않아 $v1.0$ 에서 $v1.4$ 로 3단계 이상 건너뛴 유저의 세이브가 손상되는 경우입니다.
기본값 오염: 새롭게 추가된 필드에 안전한 기본값(Fallback Default)이 누락되어 음수 재화, 버그 상태의 퀘스트 단계가 주입되는 문제입니다.

오류 유형	발생 원인	유저 영향도	검증 난이도
스키마 파싱 크래시	클래스/변수명 변경 및 직렬화 어트리뷰트 누락	치명적 (게임 진입 불가)	보통 (스모크 테스트로 감지 가능)
점프 마이그레이션 누락	버전별 체이닝 로직 결함 ( $v1.0 \rightarrow v1.3$ )	치명적 (장기 미접속자 이탈)	높음 (버전별 매트릭스 필요)
연관 데이터 불일치	퀘스트 상태와 인벤토리 아이템 간 종속성 깨짐	높음 (진행 불가 버그)	높음 (도메인 로직 검증 필요)
암호화/체크섬 불일치	세이브 해시 계산 로직 변경 후 갱신 실패	치명적 (세이브 변조 오탐지로 파일 리셋)	보통 (해시 검증 로직 점검)

세이브 파일 스키마 버전 마이그레이션 단계별 검증 구조

마이그레이션 검증을 위한 핵심 테스트 설계 전략

세이브 마이그레이션 테스트는 개별 버전 간의 변화뿐만 아니라 누적된 과거의 모든 버전 상태를 안전하게 최신 버전으로 변환할 수 있는지를 보장해야 합니다.

1. 점진적 마이그레이션(Incremental Migration) 파이프라인 검증

이상적인 마이그레이션 아키텍처는 이전 버전에서 최신 버전으로 한 번에 변환하는 단일 함수가 아니라 버전 번호를 기반으로 단계별 마이그레이터를 순차 실행하는 구조입니다.

flowchart LR
    A["v1.0 Save Data"] --> B["Migrator v1 to v2"]
    B --> C["v2.0 State"]
    C --> D["Migrator v2 to v3"]
    D --> E["v3.0 State (Latest)"]
    E --> F["Integrity & Checksum Validation"]
    F --> G["Game Load Success"]

QA는 클라이언트가 세이브 파일 헤더의 SaveVersion을 정확히 식별하고 현재 버전까지 순차적인 변환 체인을 누락 없이 통과하는지 검증해야 합니다.

\text{TargetVersion} = \text{CurrentVersion}, \quad \text{MigratedData} = \prod_{k=\text{SaveVersion}}^{\text{TargetVersion}-1} M_{k \rightarrow k+1}(\text{Data})

버전 간 마이그레이션 매트릭스 테스트 구축 4단계

안정적인 세이브 마이그레이션 검증을 위해 체계적인 4단계 프로세스를 수립합니다.

1단계: 골든 세이브 데이터 세트(Golden Save Dataset) 아카이빙

마이그레이션 테스트의 품질은 테스트에 사용하는 세이브 파일의 다양성에 좌우됩니다. 각 릴리즈 빌드마다 다음과 같은 상태를 포함하는 표준 세이브 파일 아카이브를 구축해야 합니다.

튜토리얼 진행 중 세이브 (최소 데이터 세트)
엔드 콘텐츠 도달 세이브 (모든 인벤토리 슬롯, 최대 재화, 모든 업적 활성화)
퀘스트 분기별 세이브 (진행 중, 완료, 실패 상태 복합 구성)
경계값 데이터 세트 (재화 최대치 $2^{31}-1$ , 특수문자 닉네임, 슬롯 가득 찬 창고)

2단계: 크로스 버전 마이그레이션 매트릭스(Matrix) 작성

모든 이전 버전( $v1.0, v1.1, v1.2, \dots$ )에서 최신 빌드( $v1.5$ )로의 업데이트 경로를 표로 정의하고 검증합니다.

출발 버전	타깃 버전 ( $v1.5$ ) 마이그레이션 경로	주요 변경 검증 항목	테스트 상태
v1.0	$v1.0 \rightarrow v1.1 \rightarrow v1.2 \rightarrow v1.3 \rightarrow v1.4 \rightarrow v1.5$	구 인벤토리 직렬화 포맷, 초기 재화 체계	Pass
v1.2	$v1.2 \rightarrow v1.3 \rightarrow v1.4 \rightarrow v1.5$	스킬 트리 개편 데이터 변환, 룬 시스템 추가	Pass
v1.4	$v1.4 \rightarrow v1.5$	신규 월드 맵 개방 플래그, 시즌 패스 갱신	Pass

3단계: 체크섬 및 데이터 무결성(Integrity) 자동 검증

세이브 데이터 변환 후 세이브 파일 위변조 방지용 해시(HMAC-SHA256 등)가 최신 암호화 규칙으로 재계산되어 저장되는지 확인합니다. 또한 데이터 변환 전후의 보존 가치가 유지되는지 정량 검증을 수행합니다.

\Delta \text{Gold} = \text{Gold}_{\text{after}} - \text{Gold}_{\text{before}} = 0

만약 통화 개편으로 인한 환율 변환이 존재한다면 정의된 교환비 공식에 맞게 정확히 계산되었는지 단언(Assert)합니다.

4단계: NUnit/xUnit 기반 마이그레이션 단위 및 통합 테스트 작성

빌드 배포 전 CI 파이프라인에서 레거시 세이브 데이터를 최신 로더에 주입하여 검증하는 테스트 코드를 작성합니다.

[TestFixture]
public class SaveMigrationTests
{
    [TestCase("SaveFiles/Golden_v1_0.json", 1, 5)]
    [TestCase("SaveFiles/Golden_v1_2.json", 2, 5)]
    [TestCase("SaveFiles/Golden_v1_4.json", 4, 5)]
    public void Test_SaveFile_MigratesSuccessfully_ToLatestVersion(
        string filePath, int fromVersion, int targetVersion)
    {
        // 1. 레거시 세이브 로드
        string rawJson = File.ReadAllText(filePath);
        var legacySave = SaveSerializer.DeserializeHeader(rawJson);
        Assert.AreEqual(fromVersion, legacySave.SchemaVersion);

        // 2. 마이그레이션 파이프라인 실행
        var migrationResult = SaveMigrationPipeline.MigrateToLatest(rawJson);
        Assert.IsTrue(migrationResult.IsSuccess, $"Migration failed: {migrationResult.ErrorMessage}");

        // 3. 최신 데이터 구조 역직렬화 검증
        var latestData = SaveSerializer.Deserialize<GameSaveDataV5>(migrationResult.MigratedJson);
        Assert.AreEqual(targetVersion, latestData.SchemaVersion);
        Assert.IsNotNull(latestData.PlayerStats);
        Assert.IsNotNull(latestData.Inventory);
        
        // 4. Fallback 기본값 및 경계값 검증
        Assert.GreaterOrEqual(latestData.Inventory.SlotCapacity, 50);
        Assert.GreaterOrEqual(latestData.Currency.Gold, 0);
    }
}

자동화된 세이브 마이그레이션 매트릭스 테스트 결과 리포트

실무에서 자주 발생하는 엣지 케이스 점검 체크리스트

라이브 환경에서는 단순 필드 추가 외에도 복잡한 도메인 결합 문제가 발생합니다. 다음 항목을 체크리스트로 관리해야 합니다.

삭제된 아이템/스킬 참조: 기획상 삭제된 아이템 ID를 장착 중이던 세이브가 로드될 때 대체 아이템으로 지급되거나 안전하게 인벤토리에서 제거되는가?
인벤토리 용량 축소 시 오버플로우: 기본 가방 슬롯이 축소되거나 구조가 변경되었을 때 초과 아이템이 우편함이나 임시 보관함으로 안전하게 이관되는가?
퀘스트 의존성 트리 꼬임: 완료 조건이 변경된 퀘스트를 진행 중이던 유저가 퀘스트 중단 상태나 소프트락(Soft-lock)에 걸리지 않고 재수행 가능한 상태로 리셋되는가?
클라우드 동기화 타임스탬프 충돌: 마이그레이션이 완료된 로컬 파일과 아직 마이그레이션되지 않은 구버전 클라우드 세이브 간의 충돌 해결(Conflict Resolution) 정책이 올바르게 동작하는가?
디바이스 저장 공간 부족: 마이그레이션 중 임시 파일 생성 및 백업 과정에서 디스크 용량이 부족할 때 원본 파일이 손상되지 않고 롤백되는가?

자주 묻는 질문 (FAQ)

Q1. 플레이어가 여러 버전을 건너뛰었을 때(예: v1.0에서 v1.5) 마이그레이션 검증은 어떻게 해야 하나요?

각 버전별 마이그레이터가 체인 형태로 연결되어 있는지 확인해야 합니다. $v1.0 \rightarrow v1.5$ 직접 변환 함수를 별도로 만들면 버전이 늘어날수록 조합의 수가 $O(N^2)$ 으로 폭증하여 유지보수가 불가능해집니다. 따라서 $v1.0 \rightarrow v1.1 \rightarrow v1.2 \rightarrow \dots \rightarrow v1.5$ 로 순차 실행되는지 단일 경로 파이프라인을 검증하고 모든 과거 메이저 버전의 골든 세이브 파일을 최신 빌드에 직접 로드하는 통합 테스트를 수행해야 합니다.

Q2. 세이브 데이터 암호화 방식이나 직렬화 라이브러리가 변경되면 QA는 무엇을 확인해야 하나요?

직렬화 라이브러리(예: JSON에서 Protocol Buffers 또는 FlatBuffers로 전환)나 암호화 키가 변경될 경우, 로더는 구버전 바이너리/텍스트 포맷을 먼저 감지하고 복호화한 뒤 신규 포맷으로 재인코딩하여 저장해야 합니다. QA는 구버전 포맷 감지 분기, 복호화 실패 시 Fallback 처리, 최신 포맷으로의 재저장 후 파일 크기 및 I/O 쓰기 시간 성능을 집중 검증해야 합니다.

Q3. 라이브 업데이트 직후 세이브 마이그레이션 실패 크래시가 발생했을 때 비상 대응 검증 절차는 무엇인가요?

마이그레이션 시작 전 반드시 원본 세이브 파일의 백업 사본(.bak)을 생성하는 로직이 구현되어 있는지 사전 검증되어 있어야 합니다. 실패 발생 시 클라이언트는 손상된 상태를 덮어쓰지 않고 즉시 백업 파일로 복원하며 에러 로그를 센트리(Sentry)나 분석 서버로 전송해야 합니다. QA는 마이그레이션 도중 강제 프로세스 종료(Crash injection) 시에도 원본 데이터가 안전하게 복구되는지 멱등성(Idempotency) 테스트를 진행합니다.

마치며

세이브 데이터 유실은 오랜 플레이 시간과 노력을 잃게 해 게임 이탈로 이어질 수 있는 심각한 문제입니다. 골든 세이브 데이터 아카이빙, 단계별 마이그레이션 체인, CI 기반 자동화 매트릭스 테스트를 마련하면 버전 업데이트 중 데이터 사고가 발생할 위험을 낮출 수 있습니다.