5 Error Android Studio Paling Sering & Cara Mengatasinya (Lengkap)

Android Studio adalah IDE resmi untuk pengembangan aplikasi Android, tapi pesan error-nya sering bikin pusing. Kabar baiknya, error-nya itu-itu saja polanya. Artikel ini merangkum 5 error Android Studio paling sering muncul beserta arti pesan, langkah perbaikan dari yang termudah, cara verifikasi, dan pencegahannya.

Polanya selalu sama: baca pesan error persisnya → perbaiki dari yang termudah → verifikasi hasilnya → cegah terulang.

1. Gradle sync failed / build gagal

Gradle sync failed

Could not resolve all files for configuration ':app:debugCompileClasspath'.
> Could not resolve com.android.tools.build:gradle:8.7.0.

Artinya: Gradle gagal mengunduh atau mengonfigurasi kebutuhan build. Penyebab umum: tidak ada internet, offline mode aktif padahal dependensi belum di-cache, atau versi Android Gradle Plugin tidak cocok.

Cara memperbaiki: (1) Matikan Offline Mode di File > Settings > Build Tools > Gradle kalau butuh unduh dependensi baru. (2) File > Sync Project with Gradle Files; kalau masih gagal, File > Invalidate Caches / Restart. (3) Pastikan google() dan mavenCentral() terdaftar di settings.gradle. (4) Cek kecocokan versi: AGP 8.x butuh Gradle 8.x dan JDK 17.

Verifikasi: jendela Build menampilkan Gradle sync finished tanpa error merah.

2. SDK location not found / ANDROID_HOME

SDK location not found. Define a valid SDK location with an ANDROID_HOME
environment variable or by setting the sdk.dir path in your project's
local.properties file.

Artinya: Gradle tidak tahu di mana Android SDK terinstal — paling sering saat membuka proyek hasil clone dari Git.

Cara memperbaiki: (1) File > Settings > Android SDK — pastikan Android SDK Location benar. (2) Isi sdk.dir di local.properties. (3) Atau set environment variable ANDROID_HOME ke folder SDK.

3. HAXM is not installed / emulator tidak bisa jalan

emulator: ERROR: x86_64 emulation currently requires hardware acceleration!
HAXM is not installed on this machine

Artinya: emulator butuh akselerasi virtualisasi: (1) VT-x/AMD-V aktif di BIOS, (2) driver hypervisor terinstal (Intel HAXM atau Android Emulator Hypervisor Driver untuk AMD).

Cara memperbaiki: (1) Aktifkan virtualisasi di BIOS. (2) Instal driver via Tools > SDK Manager > SDK Tools. (3) Di Windows: HAXM konflik dengan Hyper-V — matikan salah satunya. (4) Di Linux: emulator memakai KVM (qemu-kvm, grup kvm).

4. Default Activity not found

Error running 'app': Default Activity not found

Artinya: tidak ada activity di AndroidManifest.xml yang ditandai sebagai launcher.

Cara memperbaiki: pastikan activity utama punya intent-filter MAIN + LAUNCHER di manifest. Kalau proyek memang tanpa launcher (widget/service): Run > Edit Configurations > Launch Options → ganti ke Specified Activity atau Nothing.

5. Failed to resolve dependensi

Failed to resolve: com.squareup.retrofit2:retrofit:2.9.0

Artinya: Gradle tidak menemukan library dengan nama dan versi persis seperti yang ditulis.

Cara memperbaiki: (1) Cek ejaan & versi di mvnrepository.com — pastikan versi itu benar-benar ada. (2) Pastikan repository terdaftar di settings.gradle. (3) Matikan offline mode, Sync ulang.

Tabel Ringkas: Gejala → Langkah Pertama

Gejala	Langkah pertama
Gradle sync failed	Cek offline mode, Sync ulang
SDK location not found	Isi sdk.dir di local.properties
HAXM is not installed	Aktifkan VT-x/AMD-V di BIOS, instal driver
Default Activity not found	Cek intent-filter MAIN+LAUNCHER di manifest
Failed to resolve: ...	Cek versi di Maven Central, matikan offline mode

Kesimpulan

Lima error di atas mencakup sebagian besar masalah Android Studio sehari-hari. Kuncinya: salin pesan error persisnya, mulai dari solusi termudah, dan verifikasi hasilnya sebelum lanjut.

📚 Bacaan lanjutan

• Cara Membaca Error di Console: Panduan Debugging Buat Pemula — teknik membaca stack trace yang juga kepakai di Android Studio.