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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
MockMvc simulează cereri HTTP către controllere, fără server real. Spring Boot îl creează ca bean doar când îi ceri: @WebMvcTest îl configurează automat, iar @SpringBootTest are nevoie în plus de @AutoConfigureMockMvc. Fără ea, câmpul @Autowired MockMvc mvc nu are ce primi, iar contextul pică: NoSuchBeanDefinitionException: No qualifying bean of type 'org.springframework.test.web.servlet.MockMvc' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}.
În raportul de test vezi deasupra Failed to load ApplicationContext sau UnsatisfiedDependencyException: Error creating bean with name 'ProdusControllerTest'. Testul e și el un bean, cu dependențe ca oricare altul.
Alternativ, @SpringBootTest(webEnvironment = RANDOM_PORT) pornește un server real, iar testele folosesc TestRestTemplate sau WebTestClient, nu MockMvc.
De ce apare: cauzele frecvente
1Lipsește @AutoConfigureMockMvc
@SpringBootTest
class ProdusControllerTest {
@Autowired MockMvc mvc;
}@SpringBootTest
@AutoConfigureMockMvc
class ProdusControllerTest {
@Autowired MockMvc mvc;
}Adnotarea înregistrează bean-ul MockMvc în contextul testului.
2Vrei doar stratul web
@SpringBootTest
class ProdusControllerTest {
@Autowired MockMvc mvc;
}@WebMvcTest(ProdusController.class)
class ProdusControllerTest {
@Autowired MockMvc mvc;
}@WebMvcTest configurează MockMvc și încarcă doar controllerele (dependențele lor le furnizezi separat).
Repară eroarea, direct în pagină
Testul injectează MockMvc într-o clasă @SpringBootTest, iar în proiectul real contextul pică cu No qualifying bean of type 'org.springframework.test.web.servlet.MockMvc'. Adaugă pe clasa de test adnotarea care configurează MockMvc, fără să schimbi testul.
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 + "!";
}
}
@SpringBootTest
class ProdusControllerTest {
@Autowired
MockMvc mvc;
@Test
void gasesteProdusul() throws Exception {
mvc.perform(get("/api/produse/2"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.nume").value("Tastatură"));
}
}Tomcat started on port 8080 (http) Started Application ProdusControllerTest OK gasesteProdusul() Teste: 1 trecute, 0 picate
Indiciu
O adnotare din pachetul org.springframework.boot.test.autoconfigure.web.servlet, pusă pe clasa de test.
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 + "!";
}
}
@SpringBootTest
@AutoConfigureMockMvc
class ProdusControllerTest {
@Autowired
MockMvc mvc;
@Test
void gasesteProdusul() throws Exception {
mvc.perform(get("/api/produse/2"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.nume").value("Tastatură"));
}
}De ce merge
@SpringBootTest pornește contextul aplicației, dar nu creează MockMvc. @AutoConfigureMockMvc adaugă bean-ul, legat de controllerele reale ale aplicației, iar @Autowired MockMvc mvc îl primește. Simulatorul trece testul și fără adnotare, dar proiectul real o cere, iar fără ea niciun test din clasă nu rulează.
Alte forme ale mesajului
UnsatisfiedDependencyException: Error creating bean with name 'ProdusControllerTest': Unsatisfied dependency expressed through field 'mvc'No qualifying bean of type 'org.springframework.boot.test.web.client.TestRestTemplate' available
Cum o eviți pe viitor
- Pornește testele de controller dintr-un șablon:
@SpringBootTest+@AutoConfigureMockMvc, sau@WebMvcTest. - Nu amesteca:
MockMvcpentru testele fără server,TestRestTemplatedoar cuwebEnvironment = RANDOM_PORT. - Verifică dependența
spring-boot-starter-testînpom.xml, cuscopetest. - Când un test nu pornește, citește ultimul
Caused bydin raport.
Întrebări frecvente
Care e diferența dintre @SpringBootTest și @WebMvcTest?
@SpringBootTest pornește toată aplicația (service-uri, repository-uri); @WebMvcTest doar stratul web, mai repede, dar fără bean-urile de dedesubt.
Laboratorul injectează MockMvc și fără adnotare. De ce?
Simulatorul e mai îngăduitor și creează MockMvc oricum. În proiectul real, fără @AutoConfigureMockMvc, contextul testului nu pornește.
Erori înrudite
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. 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.
