[IntelliJ IDEA] 인테리제이에서 오랫동안 열지 않은 프로젝트 라이브러리 인식 오류 해결 방법

이전에 작업했던 Spring 프로젝트를 IntelliJ IDEA로 작업하려고 하면 매번 동일한 오류가 발생하는데 

외부 라이브러리를 인식하지 못하는 상태가 지속되었다 

해당 프로젝트는 과거에는 정상적으로 동작했던 프로젝트인데 인식하지 못하고 빨간 줄이 뜨며 프로젝트 실행이 안 되는 상황을 마주하니 원인 분석과 문제 해결 방법을 직접 기록하는 게 좋다고 생각해서 작성을 하게 되었습니다

💡 원인 분석

이전에는 잘 돌아가던 프로젝트가 오랫동안 사용하지 않아서 실행이 안된다

이런 프로젝트가 세월에 흔적을 남기듯 먼지가 쌓여서 문제가 발생하는 하드웨어도 아닌데 왜 이런 상황이 반복되는걸까

 

주요 원인으로는 3가지로 추측된다

 

1. Gradle/Maven 의존성 캐시 불일치

• 오랜 기간 프로젝트를 사용하지 않아 로컬 캐시와 프로젝트 설정 상태가 어긋남

2. IDE 인덱싱 정보 손상

• IntelliJ는 클래스,라이브러리 정보를 내부 인덱스로 관리
• 이 인덱스가 깨지면 정상 라이브러리도 인식하지 못함

3. 빌드 결과물과 IDE 상태 불일치

• 실제 빌드는 가능하지만 IDE 분석 결과만 깨진 상태

아무래도 라이브러리 영역에서 빨간 줄이 뜨는 현상으로 보아 Gradle 등 빌드도구의 설정 불일치가 아닐까 생각이 들었다

아니면 IDE가 프로젝트의 상태를 기억하지 못하는 상황으로 보였다

🔧 시도해본 방법

1. Gradle 프로젝트 동기화

가장 먼저 Gradle의 "모든 Gradle 프로젝트 동기화" 버튼을 눌러 Gradle의 의존성을 동기화시켜주는 작업을 해줬습니다

💢 하지만 문제가 해결이 되지는 않았습니다...

 

2. 프로젝트 다시 빌드

다음으로 IntelliJ 상단 메뉴에서 빌드 → 프로젝트 다시 빌드를 실행

✅ 결과는 문제가 해결되었습니다

모든 빨간 줄이 제거되었고 외부 라이브러리도 정상적으로 인식하게 되어 프로젝트 실행이 가능한 상태가 되었습니다

프로젝트 다시 빌드로 해결

문제 해결이 되었지만 어떤 방식으로 해결이 되었는지 궁금하게 되었습니다

간단하게 프로젝트 다시 빌드는 다음과 같은 작업을 수행한다고 합니다

• 기존 빌드 결과물 제거
• 의존성 재확인
• 클래스 패스 재구성
• IntelliJ 내부 인덱스 재동기화

해당 방법을 통해 IDE 상태를 기존으로 다시 맞춰주는 작업이라고 볼 수 있습니다