---
title: "iOS SDKのエラーを処理する"
description: "AdaptyのトラブルシューティングガイドでiOS SDKエラーを効率的に処理しましょう。"
---
Adapty SDKはすべてのエラーを`AdaptyError`というラッパーで扱います。SDKから返されるエラーは基本的にすべて`AdaptyError`です。`originalError`と`adaptyErrorCode`という2つの便利なプロパティがあります。詳細は以下をご覧ください。
**originalError**には元のエラーが含まれており、必要な場合に参照できます。[SKError](https://developer.apple.com/documentation/storekit/skerror)、[NSError](https://developer.apple.com/documentation/foundation/nserror)、または一般的なSwiftの[Error](https://developer.apple.com/documentation/swift/error)のいずれかです。このプロパティはオプショナルです。SDKが直接生成するエラー（データの不整合や欠落など）の場合、ラッパーの元となった元エラーが存在しないことがあるためです。
**adaptyErrorCode**を使うと、以下のような一般的な問題を処理できます。
- 無効な認証情報
- ネットワークエラー
- 支払いのキャンセル
- 請求の問題
- 無効なレシート
- その他多数
特定のエラーコードをチェックして適切に対応するのは非常に簡単です。
```swift showLineNumbers title="Swift"
do {
let info = try await Adapty.makePurchase(product: product)
} catch {
if error.adaptyErrorCode == .paymentCancelled {
// purchase was cancelled
// you can offer discount to your user or remind them later
}
}
```
:::tip
**デバッグ前に詳細ログを有効にしてください。** ほとんどの`AdaptyError`は、StoreKit、ネットワーク、またはバックエンドの基底エラーをラップしています。詳細ログを有効にすると（`Adapty.logLevel = .verbose` — [ロギング](sdk-installation-ios#logging)を参照）、ラップされたエラーがコンソールに出力されるため、実際の原因を特定しやすくなります。`originalError`プロパティはログレベルに関係なく設定されますが、詳細ログを使うとコンソール上で確認できます。
:::
:::important
これらの解決策で問題が解決しない場合は、サポートに連絡する前に[その他の問題](#other-issues)のセクションを確認してください。より迅速にサポートできるよう、事前の確認をお願いしています。
:::
## StoreKitエラー \{#storekit-errors\}
| エラー | コード | 解決策 |
|--------------------------------------------------------------------------------------------------------------------------------------------|------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [unknown](https://developer.apple.com/documentation/storekit/skerror/code/unknown) | 0 | 不明または予期しないエラーが発生したことを示すエラーコードです。
再試行するか、[その他の問題](#other-issues)セクションをご覧ください。 |
| [clientInvalid](https://developer.apple.com/documentation/storekit/skerror/code/clientinvalid) | 1 | クライアントが実行しようとしたアクションを許可されていないことを示すエラーコードです。 |
| [paymentCancelled](https://developer.apple.com/documentation/storekit/skerror/code/paymentcancelled) | 2 | ユーザーが支払いリクエストをキャンセルしたことを示すエラーコードです。
対応は不要ですが、ビジネスロジックの観点から、ユーザーに割引を提案したり、後日リマインドしたりすることができます。
|
| [paymentInvalid](https://developer.apple.com/documentation/storekit/skerror/code/paymentinvalid) | 3 | 支払いパラメーターの1つがApp Storeに認識されなかったことを示すエラーです。 |
| [paymentNotAllowed](https://developer.apple.com/documentation/storekit/skerror/code/paymentnotallowed) | 4 | ユーザーが支払いの承認を許可されていないことを示すエラーコードです。 |
| [storeProductNotAvailable](https://developer.apple.com/documentation/storekit/skerror/code/storeproductnotavailable) | 5 | リクエストされたプロダクトがストアで利用できないことを示すエラーコードです。
アプリを再インストールしてみてください。 |
| [cloudServicePermissionDenied](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicepermissiondenied) | 6 | ユーザーがCloudサービス情報へのアクセスを許可していないことを示すエラーコードです。 |
| [cloudServiceNetworkConnectionFailed](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicenetworkconnectionfailed) | 7 | デバイスがネットワークに接続できなかったことを示すエラーコードです。 |
| [cloudServiceRevoked](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicerevoked/) | 8 | ユーザーがこのクラウドサービスの使用許可を取り消したことを示すエラーコードです。 |
| [privacyAcknowledgementRequired](https://developer.apple.com/documentation/storekit/skerror/code/privacyacknowledgementrequired) | 9 | ユーザーがAppleのプライバシーポリシーをまだ承認していないことを示すエラーコードです。 |
| [unauthorizedRequestData](https://developer.apple.com/documentation/storekit/skerror/code/unauthorizedrequestdata) | 10 | アプリが必要な権限を持っていないプロパティを使用しようとしていることを示すエラーコードです。 |
| [invalidOfferIdentifier](https://developer.apple.com/documentation/storekit/skerror/code/invalidofferidentifier) | 11 | オファーの[`identifier`](https://developer.apple.com/documentation/storekit/skpaymentdiscount/identifier)が無効です。たとえば、App Storeでそのidentifierのオファーが設定されていないか、オファーが取り消されている場合などです。
App Store Connectで必要なオファーを設定し、有効なオファーidentifierを渡していることを確認してください。
|
| [invalidSignature](https://developer.apple.com/documentation/storekit/skerror/code/invalidsignature) | 12 | 支払い割引の署名が無効であることを示すエラーコードです。 |
| [missingOfferParams](https://developer.apple.com/documentation/storekit/skerror/code/missingofferparams) | 13 | 支払い割引のパラメーターが不足していることを示すエラーコードです。 |
| [invalidOfferPrice](https://developer.apple.com/documentation/storekit/skerror/code/invalidofferprice/) | 14 | App Store Connectで指定した価格が無効になったことを示すエラーコードです。オファーは常に割引価格である必要があります。 |
| noProductIDsFound | 1000 | ペイウォールでリクエストしたプロダクトが、App Storeに登録されているにもかかわらず購入できない状態であることを示すエラーです。`InvalidProductIdentifiers`の警告が同時に表示される場合があります。エラーなしで警告のみが表示される場合は無視してください。
このエラーが発生している場合は、[コード1000 `noProductIDsFound`エラーの修正](InvalidProductIdentifiers)セクションの手順に従ってください。
|
| productRequestFailed | 1002 | 現時点で利用可能なプロダクトを取得できません。 |
| cantMakePayments | 1003 | このデバイスではアプリ内課金が許可されていません。トラブルシューティング[ガイド](cantMakePayments)を参照してください。 |
| [cantReadReceipt](https://developer.apple.com/documentation/storekit/skerror/code/paymentcancelled) | 1005 | デバイスに有効なレシートがありません。これはサンドボックステスト中に発生することがあります。
サンドボックスでは、実際に購入を行うまで有効なレシートファイルが存在しないため、アクセス前に購入を済ませてください。サンドボックステスト中は、有効なAppleサンドボックスアカウントでデバイスにサインインしていることも確認してください。
|
| productPurchaseFailed | 1006 | プロダクトの購入に失敗しました。これは基底のStoreKitエラーをラップしています。実際の原因を確認するには`originalError`を参照するか、詳細ログを有効にしてコンソールで確認してください。ラップされたエラーは通常、上の表のStoreKitコード0〜14のいずれかで、最もよく見られるのは`paymentCancelled`、`paymentInvalid`、`paymentNotAllowed`、`invalidOfferPrice`です。特定の原因を特定できない場合は、新しい[サンドボックスプロファイル](test-purchases-in-sandbox)を試してください。それでも失敗する場合はAppleサポートにお問い合わせください。 |
| refreshReceiptFailed | 1010 | レシートの更新操作に失敗しました。 |
| fetchSubscriptionStatusFailed | 1020 | App Storeからサブスクリプションのステータスの取得に失敗しました。 |
| unknownTransactionId | 1030 | トランザクションIDが不明です。 |
| paymentPendingError | 1050 | 支払いは現在保留中です。 |
## ネットワークエラー \{#network-errors\}
| エラー | コード | 解決策 |
| :------------- | :--- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| notActivated | 2002 | Adapty SDKが有効化されていません。
スプラッシュ画面や初期のUIフックが`Adapty.activate`の完了前にAdaptyのメソッドを呼び出している場合に最もよく見られます。この症状は断続的に発生し、実機とシミュレーターではタイミングが異なるため再現しないことがあります。`activate`の完了ハンドラーまたは非同期結果を待ってから他のSDK呼び出しを行うようにしてください。詳細は[iOS SDKの呼び出し順序](ios-sdk-call-order)を参照してください。 |
| badRequest | 2003 | リクエストが不正です。
[App Storeとの連携](app-store-connection-configuration)に必要なすべての手順を完了しているか確認してください。 |
| serverError | 2004 | サーバーエラーです。
しばらく待ってから再試行してください。解決しない場合はAdaptyサポートチームにお問い合わせください。 |
| networkFailed | 2005 | ユーザーのデバイスのネットワーク接続に問題があることを示すエラーです。
VPNを無効にするか、モバイルデータ通信からWi-Fiへ、またはその逆に切り替えてみてください。 |
| decodingFailed | 2006 | レスポンスのデコードに失敗したことを示すエラーです。
コードを確認し、送信しているパラメーターが有効かどうか確認してください。たとえば、無効なAPIキーを使用している場合にもこのエラーが発生することがあります。 |
| encodingFailed | 2009 | リクエストのエンコードに失敗したことを示すエラーです。 |
## 一般エラー \{#general-errors\}
| エラー | コード | 解決策 |
| :------------------- | :--- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| analyticsDisabled | 3000 | [無効化](analytics-integration#disabling-external-analytics-for-a-specific-customer)されているため、アナリティクスイベントを処理できません。 |
| wrongParam | 3001 | パラメーターが正しくないことを示すエラーです。
Adaptyのペイウォールビルダーを使用していてこのエラーでペイウォールを表示できない場合は、ペイウォールビルダーで**Show on device**をオンにしてください。
もう一つの原因として、ローカルの[フォールバック](fallback-paywalls)ファイルのバージョンがSDKバージョンと一致していない可能性があります。ダッシュボードで新しいファイルをダウンロードしてください。 |
| activateOnceError | 3005 | `.activate`メソッドを複数回呼び出すことはできません。 |
| profileWasChanged | 3006 | 操作中にユーザープロファイルが変更されました。
`Adapty.identify`が実行中にメソッドが呼び出された場合に発生します。実行中の呼び出しが切り替わる直前のプロファイルに届き、SDKがそれを拒否します。ユーザーアクションの呼び出しの前に必ず`identify`を`await`する（または完了ハンドラーを使用する）ようにしてください。詳細は[iOS SDKの呼び出し順序](ios-sdk-call-order)を参照してください。 |
| unsupportedData | 3007 | データフォーマットがSDKでサポートされていないことを示すエラーです。 |
| unidentifiedUserLogout | 3020 | 未識別ユーザーに対して`logout`メソッドを呼び出すことはできません。 |
| fetchTimeoutError | 3101 | フェッチ操作がタイムアウトしたことを示すエラーです。 |
| operationInterrupted | 9000 | この操作はシステムによって中断されました。 |
## その他の問題 \{#other-issues\}
まだ解決策が見つからない場合は、次のステップをお試しください。
- **SDKを最新バージョンにアップグレードする**: 最新のSDKバージョンはより安定しており、既知の問題の修正が含まれているため、常に最新版へのアップグレードをお勧めします。
- **サポートチームに連絡するか、[サポートフォーラム](https://adapty.featurebase.app/)で他の開発者に相談する**
- **[support@adapty.io](mailto:support@adapty.io)またはチャットからサポートチームに連絡する**: SDKのアップグレードができない場合や、アップグレードしても解決しない場合は、サポートチームにお問い合わせください。[詳細ログを有効にして](sdk-installation-ios#logging)ログをチームと共有することで、問題の解決が早まります。関連するコードスニペットも添付できます。