VSCode - unresolved import 의존성 에러

테스트 코드를 작성하며 VSCode에서 직접 돌려보고 있는데요. 

SpringBootTest cannot be resolved to a type 와 같은 unresolved import 에러가 발생하였습니다.

 

이미 dependency로 추가 되어 있는데도, 빌드 시에 에러가 나는 경우가 종종 있는데요. 

의존성 추가 자체의 문제라기보다는 IDE에서 의존성 인식 또는 빌드 캐시 문제일 가능성이 높습니다.

 

다음은 이러한 문제의 원인이 될만한 사항들과 해결 방법 입니다.

대부분은 2번의 플러그인이 일시적으로 꼬인 문제로 Java: Clean Java Language Server Workspace 를 한번 실행해주면 해결 되는것 같네요.

 

주요 원인 및 점검 사항

• 1) Gradle 동기화/리프레시 문제
    -> VS Code에서 Gradle 프로젝트가 제대로 동기화되지 않았을 수 있습니다.
  
  해결 :
  - VS Code 좌측의 Gradle 패널에서 "Refresh"
  - 또는 명령 팔레트(Ctrl+Shift+P)에서 Gradle: Refresh Gradle Project 실행
  - 또는 터미널에서 ./gradlew clean build 실행 후 VS Code 재시작
  
  
• 2) Java Language Support 플러그인 문제
  -> VS Code의 Java Extension Pack 또는 Java Language Support 플러그인이 최신이 아니거나, 일시적으로 인식이 꼬였을 수 있습니다.
  
  해결:
  - 플러그인 업데이트
  - 명령 팔레트(Ctrl+Shift+P) 에서 Java: Clean Java Language Server Workspace 실행 후 VS Code 재시작
  
  
• 3) Gradle 캐시 문제
  -> 로컬 Gradle 캐시가 꼬여서 의존성 다운로드가 제대로 안 된 경우
  
  해결:
  - .gradle 폴더 삭제 후 다시 빌드
  ./gradlew --refresh-dependencies
  
  
• 프로젝트 구조 문제
  -> 소스 코드가 java 아래에 있어야 하며, Gradle이 해당 경로를 테스트 소스로 인식해야 합니다.
  
  
• 프록시/네트워크 문제로 의존성 다운로드 실패
  -> 인터넷 연결 문제로 의존성 jar가 실제로 다운로드되지 않았을 수 있습니다.
  
  해결:
  ~/.gradle/caches에서 해당 jar가 있는지 확인
  터미널에서 ./gradlew dependencies로 의존성 트리 확인