Android StudioのGeminiでリクエスト上限に達した際、実際はクォータ不足なのに「An internal error has occurred」とだけ表示される既知問題があります。本記事では、プロジェクトやGradleの不具合と誤認せず、対象バージョンを確認して安全に切り分ける方法を説明します。
表示されるエラー
An internal error has occurredこの問題では、根本の状態は次のようなクォータ枯渇です。
Quota exhausted原因
Geminiへのリクエストで利用可能なクォータを使い切ったとき、Android Studio側がその応答を適切なクォータエラーとして表示せず、汎用的な内部エラーへ変換していました。アプリのソースコード、Gradle設定、IDEキャッシュの破損が直接の原因とは限りません。
発生条件と対象バージョン
- Android Studioに組み込まれたGeminiを使用している
- 利用中のGoogleアカウント、契約、またはバックエンドでリクエストクォータを消費し切っている
- Android Studio Quail 2 Canary 5より前の、該当する不具合を含むビルドを利用している
Googleの修正一覧ではIssue #516312099がAndroid Studio Quail 2 Canary 5で修正済みとされています。同時掲載のAGPは9.3.0-alpha10ですが、この修正はAndroid Studio／Geminiのエラー表示に関するもので、AGPだけを更新して直る種類の問題ではありません。
推奨する解決手順
- IDEのバージョンを確認する：「Help」→「About」（macOSでは「Android Studio」→「About Android Studio」）を開きます。
- Android Studioを更新する：Quail 2 Canary 5以降、またはこの修正を含む後続の安定版へ更新します。
- IDEを再起動する：更新後にAndroid Studioを終了し、再起動してGeminiへ同じ種類のリクエストを送ります。
- クォータの状態を確認する：正しいGoogleアカウントでログインしているか、利用プランや組織側の制限、リセット時刻を確認します。
- クォータ回復後に再試行する：IDE更新は表示を明確にしますが、消費済みクォータそのものを追加するものではありません。
重要：更新後に「Quota exhausted」など具体的な制限が表示される場合、IDEの修正は機能しています。利用枠が戻るまで待つか、管理者・契約管理画面で利用条件を確認してください。
代替策
- クォータのリセットまで通常のエディタ機能や手作業で開発を続ける
- 組織の規約で許可され、別の正当な利用枠がある場合のみ、適切なアカウントや提供モデルへ切り替える
- 安定版運用が必要で直ちにIDEを更新できない場合、現在の環境を維持しつつクォータ回復を待つ
キャッシュ削除、Gradleの再同期、プロジェクト再作成は、このクォータ不足を解消する手段ではありません。
確認方法
- Android StudioがQuail 2 Canary 5以降、または修正を含む後続版であることを確認します。
- クォータが残っている状態でGeminiへの短いリクエストが正常に完了することを確認します。
- クォータ不足時に、汎用的な内部エラーだけでなく、利用枠に関する具体的な案内が表示されることを確認します。
注意点
「An internal error has occurred」は、通信障害、認証切れ、サービス障害など別の原因でも表示され得ます。アカウントや管理画面でクォータ枯渇を確認できない場合は、本件と断定せず、再ログイン、ネットワーク、Android Studioのログ、Google側のサービス状態を個別に確認してください。
まとめ
Geminiのクォータ枯渇が「An internal error has occurred」と誤表示される問題は、Android Studio Quail 2 Canary 5で修正されています。IDEを修正版へ更新したうえで、実際の利用枠を確認し、クォータ回復後に再試行するのが基本です。
参照した公式情報
