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

java.lang.AssertionError: JSON path "$" Expected: a collection with size <3> but: collection size was <2>

Pe scurt

Î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

Greșit
JAVA
return produse.subList(0, Math.min(limita - 1, produse.size()));
Corect
JAVA
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ă

Greșit
JAVA
.andExpect(jsonPath("$", hasSize(3)))
// răspunsul: {"continut": [...], "total": 3}
Corect
JAVA
.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ă

Greșit
JAVA
mvc.perform(get("/api/produse"))
   .andExpect(jsonPath("$.content", hasSize(30)));
Corect
JAVA
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ă tu

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.

Codul care dă eroarea
JAVA
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)));
    }
}
După reparație, programul afișează
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)?

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 $.totalElements separat.

Î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

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