org.opentest4j.AssertionFailedError: expected: not <null>
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
Produs gaseste(String cod) {
return produse.get(cod.toLowerCase());
}
// cheile din Map sunt "A1", "B2"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”
Produs gaseste(long id) {
return repo.findById(id).orElse(null);
}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ă
@Test
void gaseste() {
assertNotNull(repo.findByEmail("ana@exemplu.ro"));
}@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ă 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.
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"));
}
}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?
Reparația
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.toUpperCase());
}
}
@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"));
}
}De ce merge
Metoda transforma codul în litere mici (a1), dar cheile din Map sunt scrise cu litere mari, deci get întorcea null și assertNotNull pica. Cu toUpperCase(), atât A1, cât și b2 ajung la forma cheilor salvate și produsele sunt găsite. Ambele teste trec fără să le schimbi.
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
assertNotNulldin testele cu mai multe verificări. - Evită să întorci
nulldin servicii: foloseșteOptionalsau 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
org.opentest4j.AssertionFailedError: expected: <288> but was: <199> O aserțiune assertEquals din JUnit 5 a comparat valoarea așteptată (primul argument) cu cea reală (al doilea) și au ieșit diferite. Fie codul testat are un bug, fie așteptarea din test e greșită. Recalculează de mână rezultatul corect și verifică ordinea argumentelor. java.lang.AssertionError: Expecting actual not to be null O aserțiune AssertJ assertThat(x).isNotNull() (sau orice aserțiune pe un obiect null) a primit null. Valoarea testată nu a fost completată: o mapare care uită un câmp, o căutare care nu găsește nimic sau o dependență neinjectată. Găsește de unde vine null și repară codul. org.opentest4j.AssertionFailedError: expected: <true> but was: <false> assertTrue a primit o condiție falsă. Mesajul nu spune ce condiție, așa că adaugă un mesaj ca al doilea argument sau folosește o aserțiune mai precisă (assertEquals, assertThat(x).isGreaterThan(y)). Apoi verifică dacă greșește condiția din test sau codul testat. Î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.
