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

org.opentest4j.AssertionFailedError: expected: not <null>

Pe scurt

O aserțiune assertNotNull din JUnit 5 a primit null. Codul testat nu a găsit sau nu a creat obiectul pe care îl așteptai. Verifică de ce metoda întoarce null (o cheie greșită, o căutare care nu găsește nimic, un câmp necompletat) și repară codul, nu testul.

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

Ce înseamnă

assertNotNull(x) din JUnit 5 (org.junit.jupiter.api.Assertions) trece doar dacă x nu este null. Când este, aruncă AssertionFailedError cu mesajul expected: not <null>: aserțiunea aștepta orice altceva decât null.

Mesajul nu-ți spune ce variabilă era null, ci doar linia aserțiunii (o vezi în stiva de apeluri, la NumeTest.java:23). Dacă testul are mai multe assertNotNull, pune un mesaj ca al doilea argument: assertNotNull(p, "produsul A1 lipsește").

În aplicațiile Spring, cauzele obișnuite sunt: o căutare într-un Map sau într-un repository cu o cheie scrisă altfel (litere mari/mici, spații), o metodă care întoarce null în loc de Optional, un câmp pe care maparea l-a uitat, sau o dependență pe care testul o creează cu new, fără să treacă prin Spring.

De ce apare: cauzele frecvente

1Cheia de căutare nu se potrivește

Greșit
JAVA
Produs gaseste(String cod) {
    return produse.get(cod.toLowerCase());
}
// cheile din Map sunt "A1", "B2"
Corect
JAVA
Produs gaseste(String cod) {
    return produse.get(cod.toUpperCase());
}

Map.get întoarce null pentru o cheie inexistentă; codul trebuie normalizat la forma în care au fost salvate cheile.

2Metoda întoarce null pentru „nu am găsit”

Greșit
JAVA
Produs gaseste(long id) {
    return repo.findById(id).orElse(null);
}
Corect
JAVA
Optional<Produs> gaseste(long id) {
    return repo.findById(id);
}
// în test: assertTrue(service.gaseste(1).isPresent());

Cu Optional, cazul „lipsă” e explicit, iar testul spune clar ce verifică.

3Datele de test nu există

Greșit
JAVA
@Test
void gaseste() {
    assertNotNull(repo.findByEmail("ana@exemplu.ro"));
}
Corect
JAVA
@Test
void gaseste() {
    repo.save(new Client("Ana", "ana@exemplu.ro"));
    assertNotNull(repo.findByEmail("ana@exemplu.ro"));
}

Testul trebuie să-și pregătească singur datele, în loc să depindă de ce se află întâmplător în bază.

Repară tu

Repară eroarea, direct în pagină

Ambele teste din CatalogServiceTest pică cu expected: not <null>: CatalogService.gaseste nu găsește nici A1, nici b2. Testele sunt corecte (codurile din catalog sunt cu litere mari, iar clientul le poate scrie oricum). Repară metoda, fără să modifici testele.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.stereotype.Service;
import org.junit.jupiter.api.*;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import static org.junit.jupiter.api.Assertions.*;
import java.util.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

record Produs(String cod, String nume, int pret) { }

@Service
class CatalogService {
    private final Map<String, Produs> produse = Map.of(
            "A1", new Produs("A1", "Mouse", 89),
            "B2", new Produs("B2", "Tastatură", 199));

    Produs gaseste(String cod) {
        return produse.get(cod.toLowerCase());
    }
}

@SpringBootTest
class CatalogServiceTest {
    @Autowired
    CatalogService catalog;

    @Test
    void gasesteProdusulDupaCod() {
        Produs p = catalog.gaseste("A1");
        assertNotNull(p);
        assertEquals("Mouse", p.nume());
    }

    @Test
    void gasesteCodulScrisCuLitereMici() {
        assertNotNull(catalog.gaseste("b2"));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
CatalogServiceTest
  OK    gasesteProdusulDupaCod()
  OK    gasesteCodulScrisCuLitereMici()
Teste: 2 trecute, 0 picate
Indiciu

Cheile din Map sunt "A1" și "B2": în ce formă trebuie adus codul primit?

Alte forme ale mesajului

  • org.opentest4j.AssertionFailedError: produsul A1 lipsește ==> expected: not <null>
  • java.lang.AssertionError: Expecting actual not to be null

Cum o eviți pe viitor

  • Adaugă un mesaj la fiecare assertNotNull din testele cu mai multe verificări.
  • Evită să întorci null din servicii: folosește Optional sau aruncă o excepție clară.
  • Normalizează cheile (litere, spații) într-un singur loc, de exemplu la salvare și la căutare.
  • Pregătește datele în fiecare test (@BeforeEach) și nu te baza pe ordinea testelor.

Întrebări frecvente

Ce diferență e față de NullPointerException?

expected: not <null> înseamnă că testul a prins null-ul controlat, la aserțiune. Fără assertNotNull, codul ar fi mers mai departe și ar fi căzut cu NullPointerException la primul apel pe obiect.

Cum văd care variabilă e null?

Uită-te la linia din stiva de apeluri și pune un mesaj ca al doilea argument al aserțiunii. Mesajul apare înainte de ==> expected: not <null>.

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.