Spring Boot SpringApplication 클래스 오류 해결Spring Boot 의존성 문제 해결 방법MavenGradle 의존성 다운로드 문제 해결backend

SpringApplication cannot be resolved 문제 해결 방법

KUKJIN LEE
KUKJIN LEE
2025년 3월 17일
416

Java에서 SpringApplication 클래스를 찾을 수 없다는 것을 의미합니다. 주로 Spring Boot 프로젝트에서 발생하는 문제로, 다음과 같은 이유로 발생할 수 있습니다.

 

  1. 의존성 누락: 프로젝트의 pom.xml 또는 build.gradle 파일에 Spring Boot 스타터 의존성이 올바르게 추가되지 않았을 수 있습니다. spring-boot-starter-web 같은 기본 Spring Boot 스타터 패키지를 포함시키는 것이 필요합니다.

  2. IDE 설정 문제: IntelliJ IDEA, Eclipse 등의 IDE가 프로젝트 의존성을 정확히 인식하지 못할 수 있습니다. 이런 경우 프로젝트를 새로고침하거나, 의존성 관리 도구(Maven, Gradle)를 사용하여 프로젝트를 다시 빌드해 보세요.

  3. 클래스패스 문제: 컴파일러가 클래스패스에서 SpringApplication 클래스를 찾지 못할 수 있습니다. 명령줄에서 직접 컴파일하는 경우, -cp 또는 -classpath 옵션을 사용하여 Spring Boot 관련 jar 파일의 위치를 지정해야 할 수 있습니다.

 

하지만 기존에 잘 작동하던 프로젝트에 문제가 발생했다면?

2번까지는 꼭 해보시는 걸 추천 드립니다.

  1. VSCode 재시작: 때때로 VSCode나 확장 프로그램이 제대로 로드되지 않아 문제가 발생할 수 있습니다. VSCode를 완전히 종료한 후 다시 시작해 보세요.

  2. 프로젝트 새로 고침: VSCode에서 프로젝트 폴더를 오른쪽 클릭하고 Refresh를 선택하거나, Command Palette(⇧⌘P 또는 Ctrl+Shift+P)를 열고 Java: Clean Java Language Server Workspace를 실행하여 프로젝트를 새로 고침합니다.

  3. 의존성 다시 다운로드: Maven이나 Gradle 캐시에서 문제가 발생했을 수 있으므로, 의존성을 다시 다운로드해야 할 수 있습니다. Maven을 사용하는 경우 터미널에서 mvn clean install을, Gradle을 사용하는 경우 gradle build --refresh-dependencies를 실행합니다.

  4. Java JDK 설정 확인: 사용 중인 JDK가 프로젝트 요구 사항에 맞는 버전인지 확인합니다. JAVA_HOME 환경 변수가 올바르게 설정되어 있고, VSCode 내에서도 올바른 JDK가 선택되어 있는지 확인합니다.

 

위 단계를 수행한 후에도 문제가 지속되면, 프로젝트 설정이나 코드에 더 깊은 문제가 있을 수 있습니다.

#Spring Boot SpringApplication 클래스 오류 해결#Spring Boot 의존성 문제 해결 방법#Maven#Gradle 의존성 다운로드 문제 해결#backend