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

No qualifying bean of type 'org.springframework.test.web.servlet.MockMvc' available: expected at least 1 bean which qualifies as autowire candidate

Pe scurt

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

Greșit
JAVA
@SpringBootTest
class ProdusControllerTest {
    @Autowired MockMvc mvc;
}
Corect
JAVA
@SpringBootTest
@AutoConfigureMockMvc
class ProdusControllerTest {
    @Autowired MockMvc mvc;
}

Adnotarea înregistrează bean-ul MockMvc în contextul testului.

2Vrei doar stratul web

Greșit
JAVA
@SpringBootTest
class ProdusControllerTest {
    @Autowired MockMvc mvc;
}
Corect
JAVA
@WebMvcTest(ProdusController.class)
class ProdusControllerTest {
    @Autowired MockMvc mvc;
}

@WebMvcTest configurează MockMvc și încarcă doar controllerele (dependențele lor le furnizezi separat).

Repară tu

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.

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 + "!";
    }
}

@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ă"));
    }
}
După reparație, programul afișează
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.

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: MockMvc pentru testele fără server, TestRestTemplate doar cu webEnvironment = RANDOM_PORT.
  • Verifică dependența spring-boot-starter-test în pom.xml, cu scope test.
  • Când un test nu pornește, citește ultimul Caused by din 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

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