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

java.lang.AssertionError: Range for response status value 200 expected:<CLIENT_ERROR> but was:<SUCCESSFUL>

Pe scurt

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ă

Greșit
JAVA
mvc.perform(get("/api/produse/1"))
   .andExpect(status().is4xxClientError());
Corect
JAVA
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ă

Greșit
JAVA
@GetMapping("/api/reducere")
int reducere(@RequestParam int procent) { ... } // acceptă 500
Corect
JAVA
@GetMapping("/api/reducere")
int reducere(@RequestParam @Min(0) @Max(100) int procent) { ... }

Cu validare, un procent absurd primește 400.

Repară tu

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.

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
@AutoConfigureMockMvc
class ProdusControllerTest {
    @Autowired
    MockMvc mvc;

    @Test
    void produsInexistent() throws Exception {
        mvc.perform(get("/api/produse/1"))
                .andExpect(status().is4xxClientError());
    }
}
După reparație, programul afișează
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.

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

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