java.lang.AssertionError: JSON path "$" Expected: a collection with size <3> but: collection size was <2>
Într-un test MockMvc, jsonPath("$", hasSize(3)) a găsit în răspunsul JSON o listă cu alt număr de elemente. Fie endpoint-ul întoarce prea multe sau prea puține elemente (filtru, paginare, limită greșită), fie expresia JSON path arată spre altă listă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul are trei părți. JSON path "$" este expresia verificată ($ e rădăcina răspunsului; $.produse ar fi un câmp). Expected: a collection with size <3> vine de la matcher-ul Hamcrest hasSize(3). but: collection size was <2> spune ce a găsit în răspunsul real.
Eroarea apare în testele MockMvc (andExpect(jsonPath("$", hasSize(3)))) și înseamnă că endpoint-ul a răspuns cu succes, dar cu altă cantitate de date. Cauzele obișnuite sunt o limită calculată greșit (subList(0, limita - 1)), o paginare cu altă dimensiune, un filtru care exclude prea mult sau date de test diferite.
Ca să vezi răspunsul complet, adaugă .andDo(print()) în test: MockMvc afișează corpul răspunsului și poți compara elementele.
De ce apare: cauzele frecvente
1Limita este calculată greșit
return produse.subList(0, Math.min(limita - 1, produse.size()));return produse.subList(0, Math.min(limita, produse.size()));subList(0, n) întoarce deja n elemente (indicele final e exclus); scăderea lui 1 pierdea un element.
2Expresia arată spre altă listă
.andExpect(jsonPath("$", hasSize(3)))
// răspunsul: {"continut": [...], "total": 3}.andExpect(jsonPath("$.continut", hasSize(3)))Când lista e într-un obiect (de exemplu un Page), $ este obiectul întreg, nu lista.
3Paginarea are altă dimensiune implicită
mvc.perform(get("/api/produse"))
.andExpect(jsonPath("$.content", hasSize(30)));mvc.perform(get("/api/produse").param("size", "30"))
.andExpect(jsonPath("$.content", hasSize(30)));Pageable are implicit 20 de elemente pe pagină; cere explicit dimensiunea pe care o verifici.
Repară eroarea, direct în pagină
Testul intoarcePrimeleTreiProduse pică cu JSON path "$" Expected: a collection with size <3>: GET /api/produse?limita=3 întoarce doar două produse. Repară calculul din controller (nu testul), ca limita 3 să dea 3 produse, iar limita 2 să dea 2.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.junit.jupiter.api.*;
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.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
import static org.hamcrest.Matchers.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
private final List<String> produse = List.of("Mouse", "Tastatură", "Monitor", "Căști", "Webcam");
@GetMapping("/api/produse")
List<String> primele(@RequestParam int limita) {
return produse.subList(0, Math.min(limita - 1, produse.size()));
}
}
@SpringBootTest
@AutoConfigureMockMvc
class ProdusControllerTest {
@Autowired
MockMvc mvc;
@Test
void intoarcePrimeleTreiProduse() throws Exception {
mvc.perform(get("/api/produse").param("limita", "3"))
.andExpect(status().isOk())
.andExpect(jsonPath("$", hasSize(3)));
}
}Tomcat started on port 8080 (http) Started Application ProdusControllerTest OK intoarcePrimeleTreiProduse() Teste: 1 trecute, 0 picate GET /api/produse?limita=2 → 200 ["Mouse","Tastatură"]
Indiciu
Al doilea argument al lui subList este exclus din rezultat: câte elemente întoarce subList(0, 3)?
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.junit.jupiter.api.*;
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.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
import static org.hamcrest.Matchers.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
private final List<String> produse = List.of("Mouse", "Tastatură", "Monitor", "Căști", "Webcam");
@GetMapping("/api/produse")
List<String> primele(@RequestParam int limita) {
return produse.subList(0, Math.min(limita, produse.size()));
}
}
@SpringBootTest
@AutoConfigureMockMvc
class ProdusControllerTest {
@Autowired
MockMvc mvc;
@Test
void intoarcePrimeleTreiProduse() throws Exception {
mvc.perform(get("/api/produse").param("limita", "3"))
.andExpect(status().isOk())
.andExpect(jsonPath("$", hasSize(3)));
}
}De ce merge
subList(0, n) întoarce elementele de la 0 la n - 1, adică exact n elemente. Codul scădea încă 1 din limită, deci fiecare răspuns avea un produs mai puțin decât cerea clientul. Fără - 1, limita 3 întoarce trei produse și testul trece; Math.min rămâne ca să nu treci de dimensiunea listei.
Alte forme ale mesajului
JSON path "$.content" Expected: a collection with size <20> but: collection size was <5>
Cum o eviți pe viitor
- Adaugă
.andDo(print())când scrii un test nou, ca să vezi răspunsul real. - Testează limitele cu valori la margine: 0, 1, exact numărul de elemente, mai mult decât există.
- Verifică și conținutul (
jsonPath("$[0]").value("Mouse")), nu doar dimensiunea. - Când răspunsul e paginat, verifică
$.contentși$.totalElementsseparat.
Întrebări frecvente
De ce nu primesc direct lista din răspuns în mesaj?
Matcher-ul Hamcrest raportează doar dimensiunea. Pentru conținut, folosește .andDo(print()) sau citește corpul cu andReturn().getResponse().getContentAsString().
Trebuie să import hasSize din altă parte?
Da, hasSize vine din Hamcrest: import static org.hamcrest.Matchers.hasSize; (sau Matchers.*). Nu e același cu hasSize din AssertJ.
Erori înrudite
java.lang.AssertionError: No value at JSON path "$.denumire" jsonPath din testul MockMvc caută în răspuns un câmp care nu există: numele e greșit, structura e alta (un obiect în loc de listă) sau răspunsul nici nu e JSON. Afișează răspunsul cu andDo(print()) și scrie calea după câmpurile reale. 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. java.lang.AssertionError: Expected size: 3 but was: 2 in: [...] Aserțiunea AssertJ hasSize(3) a primit o colecție cu alt număr de elemente (aici 2). Mesajul arată și conținutul real al colecției. Compară elementele afișate cu cele așteptate: de obicei un filtru greșit (> în loc de >=) sau date de test lipsă. Î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.
