java.lang.IllegalStateException: Failed to load ApplicationContext for [WebMergedContextConfiguration@1b2c3d4e testClass = ProdusControllerTest]
Testul @SpringBootTest nu a putut porni contextul aplicației, deci toate testele clasei pică. Mesajul e doar ambalajul: cauza reală e mai jos, la ultimul „Caused by” (un bean lipsă, o proprietate nerezolvată, o eroare de JPA). Repar-o ca pe o eroare de pornire a aplicației.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un test cu @SpringBootTest (sau @WebMvcTest, @DataJpaTest) pornește un context Spring înainte de primul test. Dacă pornirea eșuează, JUnit raportează fiecare test cu IllegalStateException: Failed to load ApplicationContext. Nu e o eroare a testului, ci a configurării aplicației văzute de test.
Cauza se află în lanțul de excepții de dedesubt. Derulează până la ultimul Caused by: acolo găsești aceleași mesaje ca la pornirea aplicației (required a bean of type ... that could not be found, Could not resolve placeholder, Not a managed type). Spring Boot afișează adesea și raportul APPLICATION FAILED TO START cu Description și Action.
De ce poate pica doar în test, deși aplicația pornește? Testul folosește src/test/resources (alt application.properties), alt profil, sau un slice (@WebMvcTest) care nu încarcă service-urile de care depinde controllerul. Spring ține contextul în cache, deci după o încercare eșuată vezi și ApplicationContext failure threshold (1) exceeded la testele următoare.
De ce apare: cauzele frecvente
1Lipsește un bean în context
interface Plata { }
@RestController
class ComandaController {
ComandaController(Plata plata) { }
}@Service
class PlataCard implements Plata { }Fără implementare, controllerul nu poate fi creat, nici în aplicație, nici în test.
2Proprietatea lipsește din configurarea de test
# src/test/resources/application.properties
# (fără app.cheie-api)
@Value("${app.cheie-api}") String cheie;# src/test/resources/application.properties
app.cheie-api=test-123Fișierul de test înlocuiește pe cel principal; copiază și proprietățile obligatorii.
3Slice-ul nu încarcă dependențele
@WebMvcTest(ComandaController.class)
class ComandaTest { }
// controllerul cere ComandaService@SpringBootTest
@AutoConfigureMockMvc
class ComandaTest { }@WebMvcTest încarcă doar stratul web; serviciile trebuie furnizate separat (un mock sau o configurare de test).
Repară eroarea, direct în pagină
Testul nu rulează: contextul nu pornește, pentru că ComandaController cere un bean Plata care nu există. Transformă PlataCard în bean, ca testul MockMvc să pornească și să treacă.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.junit.jupiter.api.*;
import static org.junit.jupiter.api.Assertions.*;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.stereotype.Service;
import org.springframework.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Produs(long id, String nume, int pret) { }
@Service
class CosService {
int total(List<Integer> preturi) {
int s = 0;
for (int p : preturi) {
s += p;
}
return s;
}
int reducere(int total, int procent) {
if (procent < 0 || procent > 100) {
throw new IllegalArgumentException("Procent invalid: " + procent);
}
return total - total * procent / 100;
}
}
@RestController
class ProdusController {
private final Map<Long, Produs> produse = new TreeMap<>(Map.of(
1L, new Produs(1, "Mouse", 89),
2L, new Produs(2, "Tastatură", 199)));
@GetMapping("/api/produse/{id}")
Produs unul(@PathVariable long id) {
Produs p = produse.get(id);
if (p == null) {
throw new org.springframework.web.server.ResponseStatusException(org.springframework.http.HttpStatus.NOT_FOUND);
}
return p;
}
@GetMapping("/api/salut")
String salut(@RequestParam String nume) {
return "Salut, " + nume + "!";
}
}
interface Plata {
String plateste(int suma);
}
class PlataCard implements Plata {
public String plateste(int suma) {
return "Plătit cu cardul: " + suma + " lei";
}
}
@RestController
class ComandaController {
private final Plata plata;
ComandaController(Plata plata) {
this.plata = plata;
}
@PostMapping("/api/comenzi")
String plaseaza(@RequestParam int suma) {
return plata.plateste(suma);
}
}
@SpringBootTest
@AutoConfigureMockMvc
class ComandaControllerTest {
@Autowired
MockMvc mvc;
@Test
void plataCuCardul() throws Exception {
mvc.perform(post("/api/comenzi").param("suma", "120"))
.andExpect(status().isOk())
.andExpect(content().string("Plătit cu cardul: 120 lei"));
}
}Tomcat started on port 8080 (http) Started Application ComandaControllerTest OK plataCuCardul() Teste: 1 trecute, 0 picate
Indiciu
Ce adnotare face din PlataCard un bean găsit de Spring?
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.junit.jupiter.api.*;
import static org.junit.jupiter.api.Assertions.*;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.stereotype.Service;
import org.springframework.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Produs(long id, String nume, int pret) { }
@Service
class CosService {
int total(List<Integer> preturi) {
int s = 0;
for (int p : preturi) {
s += p;
}
return s;
}
int reducere(int total, int procent) {
if (procent < 0 || procent > 100) {
throw new IllegalArgumentException("Procent invalid: " + procent);
}
return total - total * procent / 100;
}
}
@RestController
class ProdusController {
private final Map<Long, Produs> produse = new TreeMap<>(Map.of(
1L, new Produs(1, "Mouse", 89),
2L, new Produs(2, "Tastatură", 199)));
@GetMapping("/api/produse/{id}")
Produs unul(@PathVariable long id) {
Produs p = produse.get(id);
if (p == null) {
throw new org.springframework.web.server.ResponseStatusException(org.springframework.http.HttpStatus.NOT_FOUND);
}
return p;
}
@GetMapping("/api/salut")
String salut(@RequestParam String nume) {
return "Salut, " + nume + "!";
}
}
interface Plata {
String plateste(int suma);
}
@Service
class PlataCard implements Plata {
public String plateste(int suma) {
return "Plătit cu cardul: " + suma + " lei";
}
}
@RestController
class ComandaController {
private final Plata plata;
ComandaController(Plata plata) {
this.plata = plata;
}
@PostMapping("/api/comenzi")
String plaseaza(@RequestParam int suma) {
return plata.plateste(suma);
}
}
@SpringBootTest
@AutoConfigureMockMvc
class ComandaControllerTest {
@Autowired
MockMvc mvc;
@Test
void plataCuCardul() throws Exception {
mvc.perform(post("/api/comenzi").param("suma", "120"))
.andExpect(status().isOk())
.andExpect(content().string("Plătit cu cardul: 120 lei"));
}
}De ce merge
Contextul testului e același cu al aplicației: ComandaController are nevoie de un bean Plata, iar PlataCard era doar o clasă obișnuită. Cu @Service, Spring o găsește la scanare, controllerul se creează, contextul pornește și testul MockMvc poate trimite cererea. Aceeași reparație face să pornească și aplicația.
Alte forme ale mesajului
ApplicationContext failure threshold (1) exceeded: skipping repeated attempt to load context for [WebMergedContextConfigurationjava.lang.IllegalStateException: Failed to load ApplicationContext
Cum o eviți pe viitor
- Când vezi
Failed to load ApplicationContext, sari direct la ultimulCaused by. - Ține un test simplu
contextLoads()care pornește doar contextul: îți spune imediat dacă problema e de configurare. - Sincronizează proprietățile obligatorii între
src/main/resourcesșisrc/test/resources. - Pornește și aplicația local; de obicei pică la fel, cu un mesaj mai scurt.
Întrebări frecvente
De ce pică toate testele, nu doar unul?
Contextul se pornește o dată pentru toată clasa (și e reutilizat între clase). Dacă nu pornește, niciun test nu are pe ce rula.
Ce înseamnă failure threshold exceeded?
Spring Boot 3.2+ nu mai reîncearcă pornirea unui context care a eșuat deja. Cauza reală e la prima clasă de test care a încercat.
Erori înrudite
java.lang.IllegalStateException: Found multiple @SpringBootConfiguration annotated classes [Generic bean: class [Application], Generic bean: class [AdminApp]] Testul @SpringBootTest caută clasa de configurare urcând prin pachete și a găsit mai multe clase @SpringBootApplication, deci nu știe pe care s-o pornească. Indică explicit aplicația: @SpringBootTest(classes = Application.class), sau păstrează o singură clasă principală per modul. No qualifying bean of type 'org.springframework.test.web.servlet.MockMvc' available: expected at least 1 bean which qualifies as autowire candidate Ai injectat MockMvc într-un test @SpringBootTest, dar MockMvc nu se creează automat acolo. Adaugă @AutoConfigureMockMvc pe clasa de test (sau folosește @WebMvcTest, care îl configurează singur). java.lang.AssertionError: Status expected:<200> but was:<404> Testul MockMvc aștepta un cod HTTP, iar endpoint-ul a răspuns cu altul. Codul primit îți spune direcția: 404 = adresă sau resursă greșită, 400 = cerere invalidă, 405 = metodă HTTP greșită, 500 = excepție în server. Verifică URL-ul și datele din test, apoi codul controllerului. Î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.
