トラブルシューティング

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。

difyctl はエラーが発生すると、メッセージを stderr に書き込みます。-o json を有効にすると、エラーも単一行の JSON として出力され、安定した code フィールドと対処可能な hint が含まれます。

終了コードの完全な一覧表とエラーオブジェクトの構造については、出力形式と終了コード を参照してください。

バージョン互換性#

version_skew（difyctl とサーバーのバージョンが一致しない）#

difyctl は各 Dify リリースとともに提供され、特定のサーバーバージョンに対応しているため、どちらか一方のバージョンが変わると両者がずれることがあります。次の 2 通りで発生し、いずれも 6 で終了します。

• Dify サーバーをアップグレードした後、既存の difyctl が古くなっている場合。サーバーは HTTP 426 でそれを拒否し、アップグレードを促します。
• difyctl がサーバーより新しい場合、リクエストを送信する前に停止し、サーバーが対応バージョンより古いことを報告します。

1. バージョンの不一致かどうかを確認します。

   difyctl version

   Compatibility: incompatible … の行、またはアップグレードを促すメッセージが表示されれば、それが原因です。

2. サーバーに合う difyctl を再インストールします。DIFY_VERSION にサーバーの Dify リリースタグを設定し（サーバーが最新リリースの場合は省略可）、インストールスクリプトを再実行します。詳しくは インストール を参照してください。

終了コード：6。

認証エラー#

auth_expired#

セッションが期限切れになり、difyctl は認証済みリクエストを実行できなくなりました。

1. 再認証します。

   difyctl auth login

2. 失敗したコマンドを再実行します。

終了コード：4。

not_logged_in#

要求されたホストに対する有効なセッションがありません。

1. サインインします。

   difyctl auth login --host <url>

2. 失敗したコマンドを再実行します。

終了コード：4。

access_denied#

サインインリクエストを拒否したか、承認前にキャンセルしたため、何も認可されていません。

再実行してリクエストを承認します。

difyctl auth login

終了コード：4。

アプリエラー#

アプリが見つからない（HTTP 404）#

指定したアプリ ID が存在しないか、お使いの token ではアクセスできません。server_4xx_other として、HTTP ステータス 404 で表示されます。

1. アクセスできるアプリを一覧表示します。

   difyctl get app

2. ID を確認して再実行します。

終了コード：1。

サービス API が無効（サーバーから HTTP 403）#

アプリは存在しますが、そのサービス API が Dify コンソールでオフになっています。アプリのオーナーが有効にする必要があります。403 は server_4xx_other として表示されます。

終了コード：1。

ワークフローエラー#

ワークフローの検証エラー（HTTP 422）#

Workflow アプリが入力を拒否しました。エラーメッセージには、不足している、または無効な必須入力が一覧表示されます。

1. アプリの入力 schema を確認します。

   difyctl describe app <id>

2. --inputs の JSON を一致するように更新します。

終了コード：1。