はじめに
「さっきまで普通に動いていたAndroid Studioが、急に固まった」
「プロジェクトを開いたらGradle sync failedの赤文字だけが並ぶ」
納期直前にこの画面を見て、手が止まった経験がある開発者は少なくないはずだ。
Android Studioはビルドシステムからエディタ、エミュレータまで一体化した重量級のIDEだ。
便利さと引き換えに、環境が少しでも荒れると 重い・起動しない・同期に失敗する という三重苦に陥りやすい。
この記事では、症状別に原因を切り分け、現場で実際に効果があった対処法だけ を厳選して紹介する。
上から順に試せば、たいていの不調は解消できるはずだ。
なお、日本語化がまだの場合は以下の記事も参考にしてほしい。
まず症状を切り分ける
闇雲に設定をいじる前に、自分の症状がどのタイプかを確認してほしい。原因の見当がつくだけで、解決までの時間は大きく変わる。
| 症状 | よくある原因 | 対処の方向性 |
|---|---|---|
| 動作がもっさりする、カーソルが遅延する | メモリ不足、インデックス処理、プラグイン過多 | ヒープ増加・除外設定 |
| アイコンをクリックしても起動しない、途中でフリーズする | vmoptionsの破損、キャッシュ破損、JDK不整合 | キャッシュ削除・設定リセット |
| プロジェクトを開くとGradle sync failedになる | AGP/Gradleのバージョン不一致、依存関係の衝突 | バージョン統一・JDK確認 |
動作が重い・もっさりする場合の対処法
ヒープメモリを増やす
Android StudioはJavaで動くアプリケーションなので、割り当てメモリが少ないと途端に重くなる。Help から Edit Custom VM Options を開き、以下のように書き換える。
-Xms1024m
-Xmx4096m
-XX:ReservedCodeCacheSize=1024m
搭載メモリが16GB以上ある環境なら、-Xmxは4096m前後まで上げても問題ない。書き換えたら必ずAndroid Studioを再起動してほしい。
インデックス対象から不要なフォルダを除外する
buildやnode_modulesのような、開発時に参照しないフォルダまで律儀にインデックス化されると、それだけでCPUを食いつぶす。Settings → Project Structure → 対象フォルダを右クリックし、Mark Directory as → Excluded を選択する。地味な作業だが、体感速度への効果は大きい。
不要なプラグインを整理する
インストールした記憶すらないプラグインが、バックグラウンドでリソースを消費しているケースは多い。Settings → Plugins → Installed タブを開き、使っていないものは無効化するか削除する。特にVCS連携系や言語サポート系のプラグインは、複数入っていると競合しやすい。
Power Save Modeを活用する
急ぎでコードを追いたいだけで、リアルタイムの静的解析までは不要という場面もあるはずだ。File メニューから Power Save Mode を有効にすると、バックグラウンドの解析処理が止まり、動作が軽くなる。編集が終わったらオフに戻すのを忘れずに。
起動しない・フリーズする場合の対処法
カスタムVMオプションを疑う
過去のバージョンから引き継いだ.vmoptionsに、現行バージョンと相性の悪いオプションが残っていると、起動そのものが失敗することがある。該当ファイルを開き、独自に追加した行を一旦すべて#でコメントアウトしてから起動してみてほしい。これだけで直るケースは意外と多い。
Invalidate Caches / Restartを実行する
インデックスやキャッシュの破損は、フリーズや原因不明のエラーの定番だ。File → Invalidate Caches... を選び、表示された項目にすべてチェックを入れて再起動する。再構築には数分かかるが、遠回りに見えて一番早い解決策になることが多い。
設定ディレクトリごとリセットする
上記でも直らない場合は、設定ファイル自体が壊れている可能性がある。以下のディレクトリをリネームまたは退避させ、まっさらな状態で起動し直す。
Windows: %APPDATA%\Google\AndroidStudioXXXX.X
macOS: ~/Library/Application Support/Google/AndroidStudioXXXX.X
Linux: ~/.config/Google/AndroidStudioXXXX.X
プラグインの再インストールなど手間は発生するが、環境をゼロから作り直せるので、原因不明の不調には最も確実な手段だ。
JDKのバージョンを確認する
Android StudioとGradleが参照するJDKがずれていると、起動後すぐにクラッシュすることがある。Settings → Build, Execution, Deployment → Build Tools → Gradle から、Gradle JDKに設定されているバージョンを確認してほしい。Android Studio同梱のJDK(通常はJDK 17系または21系)を選び直すだけで解決するケースも珍しくない。
Gradle sync failedやビルドエラーへの対処
AGPとGradleのバージョンを揃える
File → Project Structure → Project から、Android Gradle Plugin(AGP)とGradleのバージョンを確認する。組み合わせに互換性がないと、同期は必ず失敗する。基本的には、Android Studioのアップデート通知に従ってプロジェクト側も追随させるのが安全だ。
依存関係のバージョンを統一する
特にJetpack ComposeやKSP(Kotlin Symbol Processing)まわりは、1バージョンでもずれると同期エラーに直結しやすい。build.gradle.ktsで以下のように、Kotlinのツールチェーンとプラグインのバージョンを揃えているか見直してほしい。
kotlin {
jvmToolchain(21)
}
plugins {
id("com.google.devtools.ksp") version "2.0.0-1.0.24"
}
プロキシ環境での失敗を疑う
社内ネットワークなど、プロキシを経由する環境ではGradleの依存関係ダウンロードが止まってしまうことがある。Settings → Appearance & Behavior → System Settings → HTTP Proxyから、PC側のプロキシ設定と合わせておく。ここが未設定のまま放置されているケースは、思いのほか多い。
それでも直らない時の最終手段
ここまでの手順を一通り試しても改善しない場合は、Android Studio本体をアンインストールし、設定ディレクトリも完全に削除したうえで、公式サイトから最新版をクリーンインストールし直すのが確実だ。回り道のように感じるかもしれないが、原因の切り分けに時間をかけるより早く解決することが多い。
まとめ
Android Studioの不調は、重い・起動しない・同期に失敗する の3パターンに整理すると、原因の見当がつきやすくなる。
- 重い場合はまず ヒープメモリとインデックス除外 を見直す
- 起動しない場合は キャッシュ削除→設定リセット の順に切り分ける
- 同期エラーは AGP・Gradle・JDKのバージョン整合性 を疑う
一つひとつは地味な作業だが、原因を押さえて対処すれば、開発を止める時間は最小限に抑えられる。
不調に振り回される前に、この記事をブックマークして手元に置いておいてほしい。


コメント