よくある問題
この章では Antigravity Tools 使用中に最もよく遭遇するエラーコードと異常シナリオを収集し、問題の根本原因を素早く特定し、解決策を見つけるのを助けます。
本章に含まれるもの
| 問題タイプ | ページ | 説明 |
|---|---|---|
| アカウント無効 | invalid_grant とアカウント自動無効化 | アカウントが突然使えなくなった？OAuth Token 失効の原因と復旧フローを理解 |
| 認証失敗 | 401/認証失敗 | リクエストが拒否された？auth_mode 設定と Header 形式を確認 |
| レート制限エラー | 429/容量エラー | 頻繁に 429？クォータ不足とアップストリームレート制限を区別し、ローテーション戦略で影響を軽減 |
| パスエラー | 404/パス互換性 | インターフェース 404？Base URL と /v1 プレフィックスの連結問題を解決 |
| ストリーム異常 | ストリーム中断/0 Token/署名無効 | レスポンスが中断または空？プロキシの自己修復メカニズムとトラブルシューティングパスを理解 |
学習パスの提案
エラーコードでトラブルシューティング：特定のエラーに遭遇したとき、直接対応するページにジャンプ
体系的に学習：遭遇する可能性のある問題を全面的に理解したい場合、以下の順序で読むことを推奨：
- 404/パス互換性 — 最も一般的な接続問題、通常最初の罠
- 401/認証失敗 — パスは合っているがリクエストが拒否された、認証設定を確認
- invalid_grant とアカウント自動無効化 — アカウントレベルの問題
- 429/容量エラー — リクエスト成功だがレート制限された
- ストリーム中断/0 Token/署名無効 — 上級問題、ストリームレスポンスと署名メカニズムに関連
前提条件
推奨事前完了
- ローカルリバースプロキシを起動し、最初のクライアントを接続 — 基本環境が正常に動作していることを確認
- アカウントを追加 — アカウント追加の正しい方法を理解
次のステップ
問題のトラブルシューティングを完了したら、さらに深く学習を続けられます：
- 高可用性スケジューリング — ローテーションと再試行戦略でエラー発生を減らす
- Proxy Monitor — ログシステムでリクエスト詳細を追跡
- 設定完全解説 — すべての設定項目の作用を理解