Tech on Game Server Services | Docs

에러 핸들링 구현 패턴

Mon, 01 Jan 0001 00:00:00 +0000

GS2 를 이용한 네트워크 기능 구현에서 에러 핸들링은 게임의 안정성과 사용자 경험(UX)에 직결됩니다. 여기서는 단순히 예외를 포착하는 데 그치지 않는 실전적인 구현 패턴을 소개합니다.

1. 에러 분류와 대응 방침

GS2 의 예외는 그 성질에 따라 크게 3가지로 분류할 수 있습니다.

분류	해당하는 예외 (예)	대응 방침
일시적인 에러	`InternalServerError`, `ServiceUnavailable`, `RequestTimeout`	자동 재시도. 몇 차례 시도해도 안 되는 경우 에러 다이얼로그를 표시.
로직/설정 에러	`BadRequest`, `NotFound`	개발 중에 해결해야 할 에러. 릴리스 후에는 버그로 간주하여 로그를 수집하고, 사용자에게는 적절한 메시지를 표시.
인증·상태 에러	`Unauthorized`, `Conflict`, `QuotaLimitExceeded`	특별한 복구 처리가 필요. 재로그인이나 데이터 재동기화(도메인 재취득)를 수행.

2. 재시도 전략 구현(지수 백오프)

서버의 과부하나 일시적인 네트워크 불안정으로 인한 에러에 대해서는 즉시 재시도하는 것이 아니라, 간격을 두고 재시도하는 “지수 백오프(Exponential Backoff)“가 권장됩니다.

트랜잭션 액션의 조합

Mon, 01 Jan 0001 00:00:00 +0000

각 서비스의 API 레퍼런스에는 「하나의 트랜잭션에 지정할 수 있는 조합」이라는 표가 있습니다. 이 페이지는 그 표를 읽기 위한 전제를 정리한 것입니다.

액션의 「종별」

각 서비스의 액션 표에 있는 「종별」은 그 액션을 트랜잭션의 검증·소비·획득 중 어느 목록에 둘 수 있는지를 나타냅니다.

액션의 이름이나 실제 효과와 일치하지 않는 경우가 있습니다. 이름이 Verify라도 소비 액션이거나, 아무것도 업데이트하지 않는데 획득 액션인 경우가 있습니다.

각 서비스의 표를 읽는 법

각 서비스의 페이지에는 그 서비스의 조작을 나열한 표가 있습니다.

SDK의 캐시 메커니즘

Mon, 01 Jan 0001 00:00:00 +0000

GS2의 Game Engine용 SDK(GS2 SDK for Unity, GS2 SDK for Unreal Engine, GS2 SDK for Godot 등)에는, 서버에서 취득한 데이터를 SDK 내부에 캐싱하는 메커니즘이 내장되어 있습니다. 이 캐시 메커니즘을 이해하면, API 호출 횟수를 줄여 게임의 응답성과 비용을 모두 개선할 수 있습니다.

캐시의 기본 동작

Domain 객체(gs2.Inventory.Namespace(...).Me(...).Inventory(...)와 같은 접근)를 통해 데이터를 취득하면, 취득한 데이터는 SDK 내부의 캐시에 보관됩니다. 동일한 리소스에 대한 재취득은 서버에 문의하지 않고 캐시에서 반환됩니다.

따라서 UI 각 부분에서 필요한 값을 매번 서버에서 가져오지 않아도, Domain 객체를 통해 몇 번이든 안심하고 값을 참조할 수 있습니다.

비용 최적화

Mon, 01 Jan 0001 00:00:00 +0000

GS2는 종량제 요금제를 채택하고 있기 때문에 게임 설계에 따라 이용 요금이 크게 달라질 수 있습니다. 이 섹션에서는 성능을 유지하면서 비용을 억제하기 위한 설계 포인트를 설명합니다.

1. API 호출 횟수 절감

GS2 요금에서 큰 비중을 차지하는 것이 API 요청 수입니다.

SDK의 캐시 메커니즘 활용

GS2 SDK에는 캐시 메커니즘이 내장되어 있습니다. 동일한 데이터를 짧은 시간에 여러 번 가져올 경우, 서버에 요청을 보내지 않고 캐시에서 반환하도록 설계되어 있습니다. SDK 각 메서드의 Future나 Async 버전을 사용할 때는 가능한 한 고수준 API(Domain 객체를 통한 접근)를 사용해 주세요.