エラー・例外

Game Server Services を利用する上で発生する一般的なエラー

GS2 が応答するエラーは一定の法則を持って応答されます。 法則を理解することで、エラーの解消が迅速に行えるようになります。

エラーメッセージの例

[{"component":"progress","message":"quest.progress.progress.error.notFound"}]
セクション説明
componentエラーが発生した対象を示し、メンバー名、メソッド名が入ります。
messageエラー箇所の詳細、エラーを表すキーワードが入ります。 サービス名.コンポーネント.error.エラー内容

主要なエラー内容

主要なエラー内容説明
failed処理に失敗しました。
invalid不正なパラメータです。
require必要な引数がありません。
tooLong引数の文字数が長すぎます。
tooMany配列の要素数が多すぎます。
exists既に存在しています。
duplicate重複、既に存在しています。
notFound見つかりませんでした。
notMatch合致しませんでした。

例外の種類

SDK によってエラーはある程度分類され、送出される例外の型が変化します。

例外エラー内容ステータスコードリトライを推奨
BadRequestExceptionリクエストの内容が不正です。400
UnauthorizedExceptionGS2との接続に必要な権限の認証ができませんでした。APIアクセスに使用しているアクセストークンの期限が切れた場合にも発生します。401
QuotaLimitExceededExceptionクォータ(割り当て)の制限を超えました。402✔︎
NotFoundExceptionリクエストの対象が見つかりませんでした。404
ConflictException処理が衝突しました。409✔︎
InternalServerErrorExceptionサーバーでエラーが発生しました。500✔︎
BadGatewayExceptionサーバーが無効なレスポンスを受け取りました。他のサーバーやGS2のマイクロサービスとの連携に失敗した時に発生します。502✔︎
ServiceUnavailableExceptionサービスでエラーが発生しました。503✔︎
RequestTimeoutExceptionリクエストがタイムアウトしました。504✔︎
UnknownException不明な例外が発生しました。

「リトライを推奨」にマークされている例外は、リクエストパラメータは正常だが、サーバーの状態によって発生する可能性があるエラーです。 このようなエラーを検知した場合、リトライすることを推奨します。

その際に成功するまでリトライするのではなく、一定回数や一定時間の経過でタイムアウトする実装を入れることを強く推奨します。 リトライをする際に、リクエスト間にスリープを入れることを推奨しており、リトライ回数に応じてスリープの長さを伸ばしていくことを推奨します。

ゲーム内でハンドリングを必要とするエラーについては、マイクロサービスごとに列挙した例外を継承したエラー固有の例外型を定義しているものがあります。 その場合、エラー固有の例外でエラーハンドリングをすることでより簡単にエラーハンドリングを実装できます。 固有のエラーを表現する例外が存在する場合、APIリファレンスのメソッドの説明に記載がありますので、そちらをご参照ください。

カオスモード

GS2 C# SDK および GS2 SDK for Unity にはカオスモードが搭載されています。 カオスモードを有効化すると、指定した割合でリトライが必要な例外をランダムに発します。

開発をカオスモードを有効にした状態で進めることで、ゲーム内のエラーハンドリングをより強固なものにすることができます。 カオスモードの有効化の方法は 初期化処理 を参照してください。