최종 업데이트: · Android Studio Gradle 빌드 무한 대기 문제 완벽 해결 가이드
빠른 요약
Android Studio에서 Gradle 빌드가 무한 대기하는 문제는 네트워크, 캐시, 설정 오류가 주요 원인입니다.
- Offline 모드 비활성화 확인
- Gradle 데몬 프로세스 중지
- 손상된 캐시 파일 제거
- 네트워크 및 프록시 설정 점검
문제 증상 확인하기
다음과 같은 현상이 나타나면 Gradle 빌드 무한 대기 문제일 수 있습니다:
- "Gradle build running..." 메시지가 사라지지 않음
- 하단 Build 탭에서 진행 상황이 멈춰 있음
- 빌드가 수 분 이상 반응 없이 멈춤
- CPU 사용률은 낮지만 Android Studio가 응답하지 않음
주요 원인 파악
1. 네트워크 연결 문제
Gradle이 의존성 라이브러리를 다운로드할 때 네트워크 차단이나 프록시 설정으로 인해 무한 대기가 발생합니다.
2. Gradle 캐시 손상
오래된 캐시 파일이 손상되거나 충돌하여 빌드 프로세스가 정상적으로 진행되지 않습니다.
3. Offline 모드 활성화
Offline 모드가 켜져 있으면 새로운 의존성을 다운로드하지 못해 빌드가 멈춥니다.
4. Gradle 데몬 충돌
이전 빌드에서 종료되지 않은 Gradle 데몬이 새로운 빌드와 충돌을 일으킵니다.
순서별 해결 방법
방법 1: Offline 모드 확인 및 비활성화
- Android Studio → Preferences → Build, Execution, Deployment → Gradle 이동 (macOS 기준)
- Offline work 체크박스가 켜져 있다면 해제
- Sync Project with Gradle Files 실행
- CLI에서는
./gradlew build --offline옵션으로 동일하게 오프라인 빌드를 실행할 수 있습니다.
macOS 환경에서 Android Studio Gradle 설정의 Offline work 체크박스를 해제하는 위치 (Windows는 File → Settings 경로 참고)
출처: Stack Overflow
방법 2: Gradle 데몬 완전 중지
터미널에서 다음 명령어 실행:
./gradlew --stop
Windows 사용자라면:
gradlew.bat --stop
방법 3: Gradle 캐시 및 IDE 캐시 삭제
Gradle 캐시 경로:
C:\Users\[사용자명]\.gradle\caches
~/.gradle/caches
IDE 캐시: Android Studio 메뉴에서 File → Invalidate Caches / Restart
- Android Studio 완전 종료
- 위 경로의
caches폴더 삭제 - Android Studio 재시작
- File → Sync Project with Gradle Files 실행
방법 4: 네트워크 및 프록시 설정 확인
회사나 학교 네트워크를 사용한다면 프록시 설정이 필요할 수 있습니다. IDE의 Appearance & Behavior → System Settings → HTTP Proxy와 gradle.properties에 모두 설정 가능:
systemProp.http.proxyHost=[프록시 주소] systemProp.http.proxyPort=[포트번호] systemProp.https.proxyHost=[프록시 주소] systemProp.https.proxyPort=[포트번호]
방법 5: Clean 및 Rebuild
- Build → Clean Project 실행
- 완료 후 Build → Rebuild Project 실행
재발 방지법
정기적인 관리 방법
- Gradle 캐시는 문제 발생 시에만 삭제
- 안정적인 네트워크 환경 유지
- 불필요한 Gradle 플러그인 제거
- AGP에 맞는 최신 Gradle 버전 유지
Gradle 버전 최신화
gradle/wrapper/gradle-wrapper.properties에서 distributionUrl 확인:
distributionUrl=https\://services.gradle.org/distributions/gradle-x.x-bin.zip
현재 사용하는 Android Gradle Plugin(AGP) 버전에 맞는 Gradle 버전을 선택해야 합니다. (AGP-Gradle 호환성 공식 표 참고)
고급 해결책
JVM 메모리 할당 증가
gradle.properties에 추가:
org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m
병렬 빌드 활성화 (선택)
# 멀티모듈 프로젝트에서만 효과 있음 org.gradle.parallel=true
명령줄로 강제 새로고침
./gradlew clean build --refresh-dependencies
의존성을 강제로 다시 다운로드합니다.
🔗 관련 자료
이 가이드가 도움이 되셨나요? 문제가 지속되면 Android Studio 공식 지원 페이지를 확인하세요.
0 댓글