[Android] "다른 프로세스가 파일을 사용 중이기 때문에 프로세스가 액세스 할 수 없습니다" 오류 트러블슈팅 🛠️

문제

안드로이드 스튜디오에서 앱을 Run했더니 "다른 프로세스가 파일을 사용 중이기 때문에 프로세스가 액세스 할 수 없습니다"라는 오류가 뜨면서 빌드에 실패했다.

 

 

 

왜 이런 오류가 발생할까? 🤔

오류 메시지: "다른 프로세스가 파일을 사용 중이기 때문에 프로세스가 액세스 할 수 없습니다" (또는 The process cannot access the file because it is being used by another process.)

이 오류는 Android Studio의 Gradle 빌드 프로세스가 특정 파일(주로 APK, 컴파일된 리소스 등)에 접근하여 쓰기 또는 읽기 작업을 시도할 때 운영체제(Windows) 내의 다른 프로세스가 해당 파일을 점유하고 있어서 발생한다.

 

 

💡 주요 원인

1. Gradle 데몬 충돌: 가장 흔한 원인이다. 이전 빌드나 현재 빌드 작업 중 Gradle 데몬 프로세스가 비정상적으로 종료되거나, 이전 작업의 잔여물이 파일 잠금을 해제하지 못한 경우이다.
2. Antivirus/보안 소프트웨어: 설치된 백신 프로그램이나 실시간 보호 기능이 빌드 출력 파일(특히 .apk 파일)을 위협 요소로 간주하고 스캔하는 과정에서 잠시 파일을 점유할 때 발생한다.
3. ADB/에뮬레이터 프로세스 충돌: 디버깅 세션이 비정상적으로 종료되면서 ADB 또는 에뮬레이터 프로세스가 파일을 잡고 있을 수 있다.

 

 

해결책

1: Gradle 캐시/프로세스 초기화 (가장 확실한 방법) ✨

대부분의 경우, Gradle 관련 프로세스를 완전히 정리하고 다시 빌드하면 문제가 해결된다.

A. Android Studio의 Clean & Rebuild

기본적으로 시도해야 할 단계이다.

1. 상단 메뉴에서 Build > Clean Project 선택
2. 이후 Run 선택

B. Gradle 데몬 강제 종료 (Must-Do)

Clean으로 해결되지 않는다면, 현재 실행 중인 모든 Gradle 데몬 프로세스를 강제로 종료한다.

1. Android Studio의 우측 하단 탭에 있는 **"Terminal"**을 클릭하여 터미널을 연다.
2. 다음 명령어를 입력하고 실행한다.
   • Windows 환경에서는 gradlew --stop으로 실행될 수도 있다.

3. taskkill /im java.exe /f

   명령을 입력한다.
4. 이 명령은 현재 PC에서 실행 중인 모든 Gradle 데몬을 확실하게 종료시킨다.

 

C. Sync Project

데몬을 종료한 후, Gradle 파일과의 동기화를 다시 시도한다.

1. 상단 메뉴에서 File > Sync Project with Gradle Files를 선택한다.
2. 이후 다시 Run 버튼을 눌러 앱을 실행한다.

 

 

 

최종 결론: 침착하게 순서대로!

"다른 프로세스가 파일을 사용 중" 오류는 프로세스 충돌이 주원인이다.

taskkill /im java.exe /f 를 통해 프로세스를 정리하면 대부분 5분 내에 해결할 수 있다.

 

 

 

 

구독과 공감♡♡은 블로그 운영에 큰 힘이 됩니다!
긍정적인 댓글 남겨주시면 감사드리며,
보완해야 할 점이 있으면 댓글로 남겨주셔도 좋습니다!