Exa の一般的なエラー

概要

Exa の最も一般的な 10 個のエラーとその解決策を素早く参照できます。

前提条件

• Exa SDK がインストール済み
• API認証情報が設定済み
• エラーログへのアクセス可能

手順

ステップ 1: エラーを特定する

ログまたはコンソールのエラーメッセージとコードを確認します。

ステップ 2: 下記のエラーと照合する

該当するエラーをドキュメント化されたケースと照合します。

ステップ 3: ソリューションを適用する

特定のエラーに対応するソリューションの手順に従います。

出力

• 特定されたエラーの原因
• 適用された修正
• 解決の確認

エラー処理

認証失敗

エラーメッセージ:

Authentication error: Invalid API key

原因: API キーが不足、期限切れ、または無効です。

ソリューション:

# API キーが設定されているか確認
echo $EXA_API_KEY

---

レート制限超過

エラーメッセージ:

Rate limit exceeded. Please retry after X seconds.

原因: 短期間に大量のリクエストが送信されました。

ソリューション: エクスポーネンシャルバックオフを実装してください。exa-rate-limits スキルを参照してください。

---

ネットワークタイムアウト

エラーメッセージ:

Request timeout after 30000ms

原因: ネットワーク接続またはサーバーレイテンシーの問題。

ソリューション:

// タイムアウトを増加させる
const client = new Client({ timeout: 60000 });

例

クイック診断コマンド

# Exa ステータスを確認
curl -s https://status.exa.com

# API接続を確認
curl -I https://api.exa.com

# ローカル設定を確認
env | grep EXA

エスカレーションパス

1. exa-debug-bundle で証拠を収集する
2. Exa ステータスページを確認する
3. リクエスト ID を添えてサポートに連絡する

リソース

• Exa ステータスページ
• Exa サポート
• Exa エラーコード

次のステップ

包括的なデバッグについては、exa-debug-bundle を参照してください。