java.lang.AssertionError: Range for response status value 200 expected:<CLIENT_ERROR> but was:<SUCCESSFUL>
Ai verificat o familie de coduri (is4xxClientError, is2xxSuccessful, is5xxServerError), iar răspunsul a avut un cod din altă familie. Aici aștepta o eroare 4xx, dar cererea a reușit (200). Verifică dacă cererea din test e cu adevărat invalidă și dacă endpoint-ul validează.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Matcher-ele status().is2xxSuccessful(), is4xxClientError(), is5xxServerError() verifică doar clasa codului, nu valoarea exactă. Când clasa diferă, mesajul arată codul primit și cele două familii: Range for response status value 200 expected:<CLIENT_ERROR> but was:<SUCCESSFUL>.
Cel mai des apare la testele de erori: testul trimite o cerere pe care o crede invalidă (un id inexistent, un parametru greșit), dar aplicația o acceptă. Fie cererea nu e chiar invalidă (id-ul există în date), fie endpoint-ul nu validează și răspunde 200 la orice.
Invers, expected:<SUCCESSFUL> but was:<SERVER_ERROR> înseamnă că o cerere validă a produs o excepție neprinsă. Pentru teste mai precise, preferă codul exact (isNotFound(), isBadRequest()): mesajul e mai clar, iar testul documentează exact contractul API-ului.
De ce apare: cauzele frecvente
1Cererea „invalidă” e de fapt validă
mvc.perform(get("/api/produse/1"))
.andExpect(status().is4xxClientError());mvc.perform(get("/api/produse/99"))
.andExpect(status().isNotFound());Produsul 1 există; pentru un 404 ai nevoie de un id absent din date.
2Endpoint-ul nu validează
@GetMapping("/api/reducere")
int reducere(@RequestParam int procent) { ... } // acceptă 500@GetMapping("/api/reducere")
int reducere(@RequestParam @Min(0) @Max(100) int procent) { ... }Cu validare, un procent absurd primește 400.
Repară eroarea, direct în pagină
Testul produsInexistent pică cu Range for response status value 200: cere un produs care există. Schimbă id-ul din test cu unul care nu există (99) și verifică exact codul 404.
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 produsInexistent() throws Exception {
mvc.perform(get("/api/produse/1"))
.andExpect(status().is4xxClientError());
}
}Tomcat started on port 8080 (http) Started Application ProdusControllerTest OK produsInexistent() Teste: 1 trecute, 0 picate
Indiciu
Produsele 1 și 2 există; alege un id absent și un matcher exact pentru 404.
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 produsInexistent() throws Exception {
mvc.perform(get("/api/produse/99"))
.andExpect(status().isNotFound());
}
}De ce merge
Produsul 1 există, deci răspunsul era 200, din familia succes, iar testul aștepta o eroare 4xx. Cu id-ul 99, controllerul aruncă ResponseStatusException cu 404. isNotFound() e mai precis decât is4xxClientError(): ar prinde și un 400 sau 405 apărut din greșeală.
Alte forme ale mesajului
Range for response status value 500 expected:<SUCCESSFUL> but was:<SERVER_ERROR>Range for response status value 404 expected:<SUCCESSFUL> but was:<CLIENT_ERROR>
Cum o eviți pe viitor
- Folosește codul exact (
isNotFound(),isBadRequest(),isCreated()) când contractul e clar. - Construiește datele pentru testele de erori explicit (un id care sigur nu există).
- Pentru fiecare endpoint, testează un caz valid și cel puțin un caz invalid.
- Folosește
andDo(print())ca să vezi răspunsul când un test pică.
Întrebări frecvente
Când are sens is4xxClientError?
Când contează doar că cererea e respinsă, nu motivul exact, de exemplu într-un test de securitate care acceptă 401 sau 403.
De ce în laborator mesajul arată 4xx și 2xx?
Simulatorul afișează familiile mai scurt (<4xx>, <2xx>); Spring scrie numele lor (CLIENT_ERROR, SUCCESSFUL). Sensul e același.
Erori înrudite
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. java.lang.AssertionError: JSON path "$.pret" expected:<99> but was:<89> Câmpul din JSON există, dar are altă valoare decât cea așteptată în test. Fie datele testului diferă de ce crezi, fie codul calculează greșit, fie tipul diferă (99 față de 99.0, text față de număr). Verifică datele și tipul valorii din răspuns. Î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.
