Cannot resolve symbol 'SpringBootApplication'
Compilatorul nu găsește adnotarea @SpringBootApplication: lipsește importul org.springframework.boot.autoconfigure.SpringBootApplication sau proiectul nu are dependențele Spring Boot (Maven/Gradle nu le-a descărcat). Adaugă importul și reîncarcă proiectul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
IntelliJ afișează Cannot resolve symbol 'SpringBootApplication', iar javac spune cannot find symbol: class SpringBootApplication. Ambele înseamnă că numele nu e cunoscut în fișier.
Cauza cea mai simplă: lipsește import org.springframework.boot.autoconfigure.SpringBootApplication; (de exemplu după ce ai copiat clasa principală fără importuri). Dacă importul există, dar e și el roșu, atunci biblioteca nu e pe classpath: lipsește spring-boot-starter din pom.xml, proiectul nu a fost reîncărcat după modificarea pom.xml, descărcarea dependențelor a eșuat (proxy, fără internet, repository greșit) sau IDE-ul folosește alt JDK decât cel cerut de proiect.
Maven arată același lucru ca package org.springframework.boot.autoconfigure does not exist.
De ce apare: cauzele frecvente
1Import lipsă
import org.springframework.boot.SpringApplication;
@SpringBootApplication
public class Application { ... }import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class Application { ... }Adnotarea este în pachetul autoconfigure, separat de SpringApplication.
2Dependențe nedescărcate
pom.xml modificat, proiect nereîncărcat
// toate importurile Spring sunt roșii./mvnw dependency:resolve
// apoi Maven > Reload project în IntelliJIDE-ul vede clasele doar după ce Maven le-a descărcat și proiectul e reîncărcat.
Repară eroarea, direct în pagină
Clasa principală a fost copiată fără toate importurile și nu compilează: Cannot resolve symbol 'SpringBootApplication'. Adaugă importul care lipsește, ca aplicația să pornească și GET /salut să răspundă Salut din Spring Boot.
import org.springframework.boot.SpringApplication;
import org.springframework.web.bind.annotation.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class SalutController {
@GetMapping("/salut")
String salut() {
return "Salut din Spring Boot";
}
}Tomcat started on port 8080 (http) Started Application GET /salut → 200 Salut din Spring Boot
Indiciu
Adnotarea este în pachetul org.springframework.boot.autoconfigure.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class SalutController {
@GetMapping("/salut")
String salut() {
return "Salut din Spring Boot";
}
}De ce merge
@SpringBootApplication nu este în același pachet cu SpringApplication, ci în org.springframework.boot.autoconfigure. Fără import, compilatorul nu știe ce e adnotarea și se oprește. Cu importul adăugat (IntelliJ îl propune cu Alt+Enter), clasa principală activează configurarea automată și scanarea componentelor, iar SalutController este găsit și răspunde.
Alte forme ale mesajului
error: cannot find symbol symbol: class SpringBootApplicationpackage org.springframework.boot.autoconfigure does not existCannot resolve symbol 'springframework'
Cum o eviți pe viitor
- Generează proiectele de la start.spring.io, cu importurile și dependențele corecte.
- Reîncarcă proiectul Maven/Gradle după fiecare modificare în
pom.xmlsaubuild.gradle. - Activează în IntelliJ adăugarea automată a importurilor (Auto Import).
- Rulează
./mvnw compiledin terminal: dacă merge acolo, problema e doar în IDE.
Întrebări frecvente
Merge din terminal, dar IntelliJ e roșu. De ce?
IDE-ul nu a reîncărcat proiectul sau folosește alt JDK. Folosește Maven > Reload Project și verifică Project Structure > SDK.
În ce pachet este SpringApplication?
org.springframework.boot.SpringApplication. Adnotarea @SpringBootApplication este în org.springframework.boot.autoconfigure.
Erori înrudite
ApplicationContextException: Unable to start web server; nested exception is ApplicationContextException: Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory bean. Spring Boot nu poate porni serverul web pentru că lipsește configurarea automată: clasa dată lui SpringApplication.run nu are @SpringBootApplication (sau @EnableAutoConfiguration), ori lipsește spring-boot-starter-web. Pune adnotarea pe clasa principală. error: package javax.persistence does not exist Proiectul folosește Spring Boot 3 (Jakarta EE), unde adnotările JPA s-au mutat din javax.persistence în jakarta.persistence. Schimbă importurile din javax.persistence.* în jakarta.persistence.*; restul codului rămâne la fel. package jakarta.validation does not exist Proiectul nu are dependența de validare: de la Spring Boot 2.3, ea nu mai vine cu spring-boot-starter-web. Adaugă spring-boot-starter-validation în pom.xml (sau build.gradle), apoi reîncarcă proiectul. Învață Spring Boot de la zero, cu exerciții la fiecare lecție
Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.
