SpringApplication cannot be resolved 문제 해결 방법

KUKJIN LEE • 2주 전 작성
Java에서 SpringApplication
클래스를 찾을 수 없다는 것을 의미합니다. 주로 Spring Boot 프로젝트에서 발생하는 문제로, 다음과 같은 이유로 발생할 수 있습니다.
-
의존성 누락: 프로젝트의
pom.xml
또는build.gradle
파일에 Spring Boot 스타터 의존성이 올바르게 추가되지 않았을 수 있습니다.spring-boot-starter-web
같은 기본 Spring Boot 스타터 패키지를 포함시키는 것이 필요합니다. -
IDE 설정 문제: IntelliJ IDEA, Eclipse 등의 IDE가 프로젝트 의존성을 정확히 인식하지 못할 수 있습니다. 이런 경우 프로젝트를 새로고침하거나, 의존성 관리 도구(Maven, Gradle)를 사용하여 프로젝트를 다시 빌드해 보세요.
-
클래스패스 문제: 컴파일러가 클래스패스에서
SpringApplication
클래스를 찾지 못할 수 있습니다. 명령줄에서 직접 컴파일하는 경우,-cp
또는-classpath
옵션을 사용하여 Spring Boot 관련 jar 파일의 위치를 지정해야 할 수 있습니다.
하지만 기존에 잘 작동하던 프로젝트에 문제가 발생했다면?
2번까지는 꼭 해보시는 걸 추천 드립니다.
-
VSCode 재시작: 때때로 VSCode나 확장 프로그램이 제대로 로드되지 않아 문제가 발생할 수 있습니다. VSCode를 완전히 종료한 후 다시 시작해 보세요.
-
프로젝트 새로 고침: VSCode에서 프로젝트 폴더를 오른쪽 클릭하고
Refresh
를 선택하거나, Command Palette(⇧⌘P 또는 Ctrl+Shift+P)를 열고Java: Clean Java Language Server Workspace
를 실행하여 프로젝트를 새로 고침합니다. -
의존성 다시 다운로드: Maven이나 Gradle 캐시에서 문제가 발생했을 수 있으므로, 의존성을 다시 다운로드해야 할 수 있습니다. Maven을 사용하는 경우 터미널에서
mvn clean install
을, Gradle을 사용하는 경우gradle build --refresh-dependencies
를 실행합니다. -
Java JDK 설정 확인: 사용 중인 JDK가 프로젝트 요구 사항에 맞는 버전인지 확인합니다.
JAVA_HOME
환경 변수가 올바르게 설정되어 있고, VSCode 내에서도 올바른 JDK가 선택되어 있는지 확인합니다.
위 단계를 수행한 후에도 문제가 지속되면, 프로젝트 설정이나 코드에 더 깊은 문제가 있을 수 있습니다.