/ko/articles/tech/error/Recent content in 에러·예외 on Game Server Services | DocsHugoko/ko/articles/tech/error/pattern/Mon, 01 Jan 0001 00:00:00 +0000/ko/articles/tech/error/pattern/<p>GS2 를 이용한 네트워크 기능 구현에서 에러 핸들링은 게임의 안정성과 사용자 경험(UX)에 직결됩니다. 여기서는 단순히 예외를 포착하는 데 그치지 않는 실전적인 구현 패턴을 소개합니다.</p> <h2 id="1-에러-분류와-대응-방침">1. 에러 분류와 대응 방침<a class="td-heading-self-link" href="#1-%ec%97%90%eb%9f%ac-%eb%b6%84%eb%a5%98%ec%99%80-%eb%8c%80%ec%9d%91-%eb%b0%a9%ec%b9%a8" aria-label="Heading self-link"></a></h2><p>GS2 의 예외는 그 성질에 따라 크게 3가지로 분류할 수 있습니다.</p> <table> <thead> <tr> <th>분류</th> <th>해당하는 예외 (예)</th> <th>대응 방침</th> </tr> </thead> <tbody> <tr> <td><strong>일시적인 에러</strong></td> <td><code>InternalServerError</code>, <code>ServiceUnavailable</code>, <code>RequestTimeout</code></td> <td><strong>자동 재시도</strong>. 몇 차례 시도해도 안 되는 경우 에러 다이얼로그를 표시.</td> </tr> <tr> <td><strong>로직/설정 에러</strong></td> <td><code>BadRequest</code>, <code>NotFound</code></td> <td><strong>개발 중에 해결해야 할 에러</strong>. 릴리스 후에는 버그로 간주하여 로그를 수집하고, 사용자에게는 적절한 메시지를 표시.</td> </tr> <tr> <td><strong>인증·상태 에러</strong></td> <td><code>Unauthorized</code>, <code>Conflict</code>, <code>QuotaLimitExceeded</code></td> <td><strong>특별한 복구 처리</strong>가 필요. 재로그인이나 데이터 재동기화(도메인 재취득)를 수행.</td> </tr> </tbody> </table> <h2 id="2-재시도-전략-구현지수-백오프">2. 재시도 전략 구현(지수 백오프)<a class="td-heading-self-link" href="#2-%ec%9e%ac%ec%8b%9c%eb%8f%84-%ec%a0%84%eb%9e%b5-%ea%b5%ac%ed%98%84%ec%a7%80%ec%88%98-%eb%b0%b1%ec%98%a4%ed%94%84" aria-label="Heading self-link"></a></h2><p>서버의 과부하나 일시적인 네트워크 불안정으로 인한 에러에 대해서는 즉시 재시도하는 것이 아니라, 간격을 두고 재시도하는 &ldquo;지수 백오프(Exponential Backoff)&ldquo;가 권장됩니다.</p>