...
Eroare Spring Boot · Teste cu JUnit și MockMvc

java.lang.IllegalStateException: Failed to load ApplicationContext for [WebMergedContextConfiguration@1b2c3d4e testClass = ProdusControllerTest]

Pe scurt

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

Greșit
JAVA
interface Plata { }
@RestController
class ComandaController {
    ComandaController(Plata plata) { }
}
Corect
JAVA
@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

Greșit
JAVA
# src/test/resources/application.properties
# (fără app.cheie-api)
@Value("${app.cheie-api}") String cheie;
Corect
JAVA
# src/test/resources/application.properties
app.cheie-api=test-123

Fișierul de test înlocuiește pe cel principal; copiază și proprietățile obligatorii.

3Slice-ul nu încarcă dependențele

Greșit
JAVA
@WebMvcTest(ComandaController.class)
class ComandaTest { }
// controllerul cere ComandaService
Corect
JAVA
@SpringBootTest
@AutoConfigureMockMvc
class ComandaTest { }

@WebMvcTest încarcă doar stratul web; serviciile trebuie furnizate separat (un mock sau o configurare de test).

Repară tu

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ă.

Codul care dă eroarea
JAVA
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"));
    }
}
După reparație, programul afișează
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?

Alte forme ale mesajului

  • ApplicationContext failure threshold (1) exceeded: skipping repeated attempt to load context for [WebMergedContextConfiguration
  • java.lang.IllegalStateException: Failed to load ApplicationContext

Cum o eviți pe viitor

  • Când vezi Failed to load ApplicationContext, sari direct la ultimul Caused 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 și src/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

← Toate erorile Spring Boot

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.