guricode

[Flutter/Android] Gradle 빌드 오류: Failed to create Jar file (jars-9.lock) 해결 방법 본문

앱/Flutter&Dart

[Flutter/Android] Gradle 빌드 오류: Failed to create Jar file (jars-9.lock) 해결 방법

agentrakugaki 2025. 6. 16. 14:23



```
java.util.concurrent.ExecutionException: org.gradle.api.GradleException: Failed to create Jar file C:\Users\사용자\.gradle\caches\jars-9\...\cp_settings.jar.
```
 이 오류로 빌드가 계속 실패해서 여러 방법을 시도해봤는데, 의외로 간단하게 해결할 수 있었습니다.  
아래에서 원인과 해결 방법을 정리해봅니다.

---

## 문제 원인

이 오류는 주로 Gradle의 캐시 디렉터리(`.gradle\caches\jars-9`)에 있는 **lock 파일(jars-9.lock)**이 손상되었거나 충돌이 발생했을 때 나타납니다.  
lock 파일이 남아 있거나 손상되면 Gradle이 캐시를 제대로 관리하지 못해 빌드가 실패할 수 있습니다.

---

## 해결 방법


1. **Gradle 캐시 폴더로 이동**
   - 경로:  
     ```
     C:\Users\사용자이름\.gradle\caches\jars-9
     ```

2. **`jars-9.lock` 파일 삭제**
   - `jars-9.lock` 파일을 찾아서 삭제합니다.

3. **프로젝트 클린 및 재빌드**
   - 터미널(명령 프롬프트)에서 프로젝트 루트(= `pubspec.yaml`이 있는 폴더)로 이동 후 아래 명령어 실행:
     ```
     flutter clean
     flutter pub get
     flutter run
     ```
   - Android 프로젝트라면:
     ```
     gradlew clean
     gradlew build
     ```

---


- 만약 위 방법으로도 해결되지 않는다면, `.gradle\caches` 폴더 전체를 삭제한 뒤 다시 빌드해보세요.
- 백신 프로그램이나 디스크 권한 문제로 인해 캐시 파일이 잠기는 경우도 있으니, 필요하다면 백신을 잠시 꺼두고 시도해보는 것도 방법입니다.

Gradle 빌드 오류 중 `Failed to create Jar file`이 발생한다면,  
**`jars-9.lock` 파일을 삭제**하는 것만으로도 쉽게 해결할 수 있습니다.