---
title: "例外処理"
url: https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/exceptions/
description: "このヘルプページでは、Flutter SDKで構築されたCatalyst AndroidおよびiOSアプリの実行時に発生する一般的な例外を一覧で示します。"
last_updated: 2026-02-23T12:39:41Z
service: All Services
type: general
related_links:
  - name: "Developer Tools"
    url: /ja/getting-started/set-up-a-catalyst-project/developer-tools
---

# 例外処理

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

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

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

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

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

### iOSアプリの例外

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

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

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

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