例外処理

# 例外処理

例外処理は、アプリの実行中に発生する予期しない不具合の動作です。Flutter SDKで構築されたAndroidまたはiOSアプリのすべてのエラーと例外は、Android SDKパッケージで定義された{{%badge%}}{{%bold%}}ZCatalystException{{%/bold%}}{{%/badge%}}という列挙型によって処理されます。

モバイルアプリで例外が発生した場合、例外の以下のDartプロパティが返されます：

* {{%bold%}}{{%badge%}}code{{%/badge%}}:{{%/bold%}} エラーの一意の識別子
* {{%bold%}}{{%badge%}}errorMsg{{%/badge%}}:{{%/bold%}} エラーに関する一般的な説明
* {{%bold%}}{{%badge%}}errorDetails{{%/badge%}}:{{%/bold%}} エラーに関する追加情報
* {{%bold%}}{{%badge%}}originalException{{%/badge%}}:{{%/bold%}} スローされた実際の例外

Catalyst Flutter SDKがスローする一般的なエラーコードとその説明を以下に示します：

<table class="content-table">
<thead>
<tr>
<th class="w30p">エラーコード</th>
<th class="w70p">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td>INITIALIZATION_ERROR</td>
<td>SDKの初期化に失敗しました</td>
</tr>
<tr>
<td>LOGIN_ERROR</td>
<td>ユーザーのログインプロセスに失敗しました</td>
</tr>
<tr>
<td>LOGOUT_FAILED</td>
<td>ユーザーのログアウトプロセスに失敗しました</td>
</tr>
<tr>
<td>TOKEN_FETCH_ERROR</td>
<td>アクセストークンの取得に失敗しました</td>
</tr>
<tr>
<td>RESPONSE_PARSE_ERROR</td>
<td>受信したレスポンスをパースできません</td>
</tr>
<tr>
<td>NO_NETWORK_AVAILABLE</td>
<td>API呼び出しを行うためのネットワーク接続が利用できません</td>
</tr>
<tr>
<td>API_FAILED</td>
<td>APIの呼び出しに失敗しました</td>
</tr>
<tr>
<td>INVALID_DATA</td>
<td>送信されたデータが特定のフォーマットに対して有効な型ではありません</td>
</tr>
<tr>
<td>FILE_SIZE_EXCEEDED</td>
<td>アップロードされたファイルのサイズが100MBのファイルサイズ制限を超えています</td>
</tr>
<tr>
<td>FUNCTION_EXECUTION_ERROR</td>
<td>関数の実行に失敗しました</td>
</tr>
<tr>
<td>JSON_EXCEPTION</td>
<td>リクエストに含まれるボディが有効なJSONではありません</td>
</tr>
<tr>
<td>INVALID_REQUEST</td>
<td>作成されたリクエストが有効ではありません</td>
</tr>
<tr>
<td>INVALID_FILE_INPUT</td>
<td>アップロード操作で送信されたファイルが有効ではありません</td>
</tr>
<tr>
<td>INTERNAL_ERROR</td>
<td>SDKで内部エラーが発生しました</td>
</tr>
<tr>
<td>INVALID_CONFIGURATION</td>
<td>ログインに必要な設定でSDKが初期化されていません。適切な設定でSDKを再初期化してください。</td>
</tr>
<tr>
<td>CUSTOM_LOGIN_DISABLED</td>
<td>サードパーティ認証に必要なパラメーターが見つかりませんでした。プロジェクトでサードパーティ認証を有効にしているか確認するか、プロパティファイルを再ダウンロードしてください。</td>
</tr>
</tbody>
</table>

### iOSアプリの例外

iOSアプリでエラーが発生した場合、エラーの以下のプロパティが返されます：

* {{%badge%}}**code**{{%/badge%}}: エラーの一意の識別子
* {{%badge%}}**message**{{%/badge%}}: エラーに関する一般的な説明
* {{%badge%}}**details**{{%/badge%}}: エラーに関する追加情報

Catalyst iOS SDKがスローする一般的なエラーコードとその説明を以下に示します：

<table class="content-table">
<thead>
<tr>
<th class="w30p">エラーコード</th>
<th class="w70p">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td>INVALID_DATA</td>
<td>データが無効なフォーマットです</td>
</tr>
<tr>
<td>INTERNAL_ERROR</td>
<td>内部の問題、サーバー、またはその他の原因によりエラーが発生しました</td>
</tr>
<tr>
<td>RESPONSE_NIL</td>
<td>サーバーからレスポンスが返されませんでした</td>
</tr>
<tr>
<td>TOKEN_FETCH_ERROR</td>
<td>アクセストークンの取得に失敗しました</td>
</tr>
<tr>
<td>OAUTH_FETCH_ERROR</td>
<td>OAUTHトークンの取得中にエラーが発生しました</td>
</tr>
<tr>
<td>UNABLE_TO_CONSTRUCT_URL</td>
<td>URLの構築中にエラーが発生しました</td>
</tr>
<tr>
<td>PROCESSING_ERROR</td>
<td>データの処理中にエラーが発生しました</td>
</tr>
<tr>
<td>TYPECAST_ERROR</td>
<td>データの型キャスト中にエラーが発生しました</td>
</tr>
<tr>
<td>NO_INTERNET_CONNECTION</td>
<td>デバイスがインターネットに接続されていません</td>
</tr>
<tr>
<td>REQUEST_TIMEOUT</td>
<td>サーバーからのレスポンスが時間内に届きませんでした</td>
</tr>
<tr>
<td>NETWORK_CONNECTION_LOST</td>
<td>デバイスのインターネット接続が切断されました</td>
</tr>
<tr>
<td>INITIALIZATION_ERROR</td>
<td>SDKの初期化中にエラーが発生しました</td>
</tr>
<tr>
<td>FUNCTION_EXECUTION_ERROR</td>
<td>関数の実行中にエラーが発生しました</td>
</tr>
<tr>
<td>JSON_EXCEPTION</td>
<td>JSONのパース中にエラーが発生しました</td>
</tr>
</tbody>
</table>

例外処理は、アプリの実行中に発生する予期しない不具合の動作です。Flutter SDKで構築されたAndroidまたはiOSアプリのすべてのエラーと例外は、Android SDKパッケージで定義されたZCatalystExceptionという列挙型によって処理されます。

モバイルアプリで例外が発生した場合、例外の以下のDartプロパティが返されます：

code: エラーの一意の識別子
errorMsg: エラーに関する一般的な説明
errorDetails: エラーに関する追加情報
originalException: スローされた実際の例外

Catalyst Flutter SDKがスローする一般的なエラーコードとその説明を以下に示します：

エラーコード	説明
INITIALIZATION_ERROR	SDKの初期化に失敗しました
LOGIN_ERROR	ユーザーのログインプロセスに失敗しました
LOGOUT_FAILED	ユーザーのログアウトプロセスに失敗しました
TOKEN_FETCH_ERROR	アクセストークンの取得に失敗しました
RESPONSE_PARSE_ERROR	受信したレスポンスをパースできません
NO_NETWORK_AVAILABLE	API呼び出しを行うためのネットワーク接続が利用できません
API_FAILED	APIの呼び出しに失敗しました
INVALID_DATA	送信されたデータが特定のフォーマットに対して有効な型ではありません
FILE_SIZE_EXCEEDED	アップロードされたファイルのサイズが100MBのファイルサイズ制限を超えています
FUNCTION_EXECUTION_ERROR	関数の実行に失敗しました
JSON_EXCEPTION	リクエストに含まれるボディが有効なJSONではありません
INVALID_REQUEST	作成されたリクエストが有効ではありません
INVALID_FILE_INPUT	アップロード操作で送信されたファイルが有効ではありません
INTERNAL_ERROR	SDKで内部エラーが発生しました
INVALID_CONFIGURATION	ログインに必要な設定でSDKが初期化されていません。適切な設定でSDKを再初期化してください。
CUSTOM_LOGIN_DISABLED	サードパーティ認証に必要なパラメーターが見つかりませんでした。プロジェクトでサードパーティ認証を有効にしているか確認するか、プロパティファイルを再ダウンロードしてください。

iOSアプリの例外

iOSアプリでエラーが発生した場合、エラーの以下のプロパティが返されます：

code: エラーの一意の識別子
message: エラーに関する一般的な説明
details: エラーに関する追加情報

Catalyst iOS SDKがスローする一般的なエラーコードとその説明を以下に示します：

エラーコード	説明
INVALID_DATA	データが無効なフォーマットです
INTERNAL_ERROR	内部の問題、サーバー、またはその他の原因によりエラーが発生しました
RESPONSE_NIL	サーバーからレスポンスが返されませんでした
TOKEN_FETCH_ERROR	アクセストークンの取得に失敗しました
OAUTH_FETCH_ERROR	OAUTHトークンの取得中にエラーが発生しました
UNABLE_TO_CONSTRUCT_URL	URLの構築中にエラーが発生しました
PROCESSING_ERROR	データの処理中にエラーが発生しました
TYPECAST_ERROR	データの型キャスト中にエラーが発生しました
NO_INTERNET_CONNECTION	デバイスがインターネットに接続されていません
REQUEST_TIMEOUT	サーバーからのレスポンスが時間内に届きませんでした
NETWORK_CONNECTION_LOST	デバイスのインターネット接続が切断されました
INITIALIZATION_ERROR	SDKの初期化中にエラーが発生しました
FUNCTION_EXECUTION_ERROR	関数の実行中にエラーが発生しました
JSON_EXCEPTION	JSONのパース中にエラーが発生しました

最終更新日 2026-02-23 18:09:41 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Developer Tools