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

java.lang.AssertionError: No value at JSON path "$.denumire"

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În MockMvc, jsonPath("$.denumire").value("Mouse") citește răspunsul ca JSON și caută câmpul denumire în obiectul rădăcină ($). Dacă nu-l găsește, aserțiunea pică cu No value at JSON path "$.denumire", înainte să compare valoarea.

Cauzele tipice:

  • câmpul se numește altfel în JSON (Jackson folosește numele componentelor record-ului sau ale getter-elor: nume, nu denumire);
  • răspunsul e o listă, deci primul element e $[0].nume, nu $.nume;
  • câmpul e imbricat: $.categorie.nume;
  • câmpul are valoarea null și e omis din JSON (@JsonInclude(NON_NULL));
  • răspunsul nu e JSON deloc (o eroare HTML, un text simplu) sau e gol (204, 404 fără corp).

Verifică întâi statusul (status().isOk()) înaintea câmpurilor: dacă răspunsul e 404, mesajul despre JSON e doar o consecință.

De ce apare: cauzele frecvente

1Numele câmpului e greșit

Greșit
JAVA
.andExpect(jsonPath("$.denumire").value("Mouse"));
// record Produs(long id, String nume, int pret)
Corect
JAVA
.andExpect(jsonPath("$.nume").value("Mouse"));

Câmpurile JSON urmează numele componentelor record-ului.

2Răspunsul e o listă

Greșit
JAVA
.andExpect(jsonPath("$.nume").value("Mouse"));
// răspuns: [{"id":1,"nume":"Mouse"}]
Corect
JAVA
.andExpect(jsonPath("$[0].nume").value("Mouse"))
.andExpect(jsonPath("$", hasSize(1)));

Pentru tablouri, accesezi elementele cu index.

3Câmpul e imbricat

Greșit
JAVA
.andExpect(jsonPath("$.oras").value("Cluj"));
// {"client":{"oras":"Cluj"}}
Corect
JAVA
.andExpect(jsonPath("$.client.oras").value("Cluj"));

Calea urmează structura obiectelor, separate prin punct.

Repară tu

Repară eroarea, direct în pagină

Testul pică cu No value at JSON path "$.denumire". Corectează calea din jsonPath după câmpurile reale ale răspunsului (record-ul Produs), ca testul să verifice numele produsului 1.

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 numeleProdusului() throws Exception {
        mvc.perform(get("/api/produse/1"))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.denumire").value("Mouse"));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
ProdusControllerTest
  OK    numeleProdusului()
Teste: 1 trecute, 0 picate
Indiciu

Ce nume are componenta cu numele produsului în record-ul Produs?

Alte forme ale mesajului

  • No value at JSON path "$[0].nume"
  • java.lang.AssertionError: No value at JSON path "$.nume": java.lang.IllegalArgumentException: json can not be null or empty

Cum o eviți pe viitor

  • Pune andExpect(status()...) înaintea aserțiunilor jsonPath.
  • Rulează cererea o dată cu andDo(print()) și copiază căile din JSON-ul real.
  • Folosește DTO-uri cu nume stabile: redenumirea unui câmp schimbă contractul API-ului și strică testele (cum e și normal).
  • Pentru liste, verifică întâi mărimea cu hasSize.

Întrebări frecvente

Ce înseamnă $ în cale?

Rădăcina documentului JSON. $.nume e câmpul nume al obiectului principal, $[0] primul element al unui tablou, $.linii[1].pret prețul celei de-a doua linii.

Cum verific că un câmp lipsește?

Cu jsonPath("$.parola").doesNotExist(), util ca să te asiguri că nu expui date sensibile.

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.