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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine din AssertJ. Apare la assertThat(x).isNotNull(), dar și la multe alte aserțiuni care au nevoie de o valoare (assertThat(x).isEqualTo(...) pe obiecte, contains, startsWith): AssertJ verifică întâi că actual, adică valoarea din assertThat(...), nu e null.
„Actual” înseamnă valoarea reală produsă de cod, spre deosebire de cea așteptată. Mesajul nu spune care expresie era null, ci doar linia din test unde a picat aserțiunea.
În aplicațiile Spring, cauzele obișnuite sunt: o metodă de mapare (entitate → DTO) care pune null sau uită un câmp, un câmp nou adăugat în entitate dar nu și în DTO, un repository care nu găsește rândul, sau un obiect creat în test cu new în loc să fie injectat. Pune as("descriere") înaintea aserțiunii ca mesajul să spună ce verifici.
De ce apare: cauzele frecvente
1Maparea uită un câmp
ClientDto inDto(Client c) {
return new ClientDto(c.getId(), c.getNume(), null);
}ClientDto inDto(Client c) {
return new ClientDto(c.getId(), c.getNume(), c.getEmail());
}Câmpul email trebuie copiat din entitate; altfel DTO-ul pleacă spre client fără el.
2Dependența nu e injectată
@SpringBootTest
class ClientMapperTest {
ClientMapper mapper;
}@SpringBootTest
class ClientMapperTest {
@Autowired
ClientMapper mapper;
}Fără @Autowired, câmpul rămâne null, iar aserțiunile pe rezultatul lui pică sau aruncă NPE.
3Căutarea nu găsește rândul
assertThat(repo.findByEmail("ana@exemplu.ro")).isNotNull();
// baza e goală în acest testrepo.save(new Client(0, "Ana Pop", "ana@exemplu.ro"));
assertThat(repo.findByEmail("ana@exemplu.ro")).isNotNull();Testul trebuie să-și creeze datele pe care le caută.
Repară eroarea, direct în pagină
Testul pastreazaEmailul pică cu Expecting actual not to be null: ClientMapper.inDto pierde emailul clientului. Repară maparea, ca DTO-ul să păstreze ana@exemplu.ro, fără să modifici testul.
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.assertj.core.api.Assertions.assertThat;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
class Client {
private final long id;
private final String nume;
private final String email;
Client(long id, String nume, String email) {
this.id = id;
this.nume = nume;
this.email = email;
}
long getId() { return id; }
String getNume() { return nume; }
String getEmail() { return email; }
}
record ClientDto(long id, String nume, String email) { }
@Service
class ClientMapper {
ClientDto inDto(Client c) {
// TODO: emailul s-a pierdut la mapare
return new ClientDto(c.getId(), c.getNume(), null);
}
}
@SpringBootTest
class ClientMapperTest {
@Autowired
ClientMapper mapper;
@Test
void pastreazaEmailul() {
ClientDto dto = mapper.inDto(new Client(7, "Ana Pop", "ana@exemplu.ro"));
assertThat(dto.email()).isNotNull();
assertThat(dto.email()).isEqualTo("ana@exemplu.ro");
}
}Tomcat started on port 8080 (http) Started Application ClientMapperTest OK pastreazaEmailul() Teste: 1 trecute, 0 picate
Indiciu
Al treilea argument din new ClientDto(...) trebuie să vină din client.
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.assertj.core.api.Assertions.assertThat;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
class Client {
private final long id;
private final String nume;
private final String email;
Client(long id, String nume, String email) {
this.id = id;
this.nume = nume;
this.email = email;
}
long getId() { return id; }
String getNume() { return nume; }
String getEmail() { return email; }
}
record ClientDto(long id, String nume, String email) { }
@Service
class ClientMapper {
ClientDto inDto(Client c) {
return new ClientDto(c.getId(), c.getNume(), c.getEmail());
}
}
@SpringBootTest
class ClientMapperTest {
@Autowired
ClientMapper mapper;
@Test
void pastreazaEmailul() {
ClientDto dto = mapper.inDto(new Client(7, "Ana Pop", "ana@exemplu.ro"));
assertThat(dto.email()).isNotNull();
assertThat(dto.email()).isEqualTo("ana@exemplu.ro");
}
}De ce merge
Metoda construia ClientDto cu null pe poziția emailului, deci dto.email() era null, iar isNotNull() pica. Cu c.getEmail() ca al treilea argument, DTO-ul primește toate datele clientului și ambele aserțiuni trec. Un test de mapare ca acesta prinde imediat câmpurile uitate.
Alte forme ale mesajului
java.lang.AssertionError: [email client] Expecting actual not to be null
Cum o eviți pe viitor
- Scrie un test de mapare pentru fiecare DTO și verifică toate câmpurile, nu doar unul.
- Când adaugi un câmp în entitate, caută toate locurile unde construiești DTO-ul.
- Folosește
as("...")în aserțiuni ca mesajul să spună ce valoare lipsește. - Preferă constructori sau record-uri pentru DTO-uri: compilatorul te obligă să dai toate valorile.
Întrebări frecvente
Ce diferență e între acest mesaj și expected: not <null>?
Sunt același tip de problemă în biblioteci diferite: Expecting actual not to be null vine din AssertJ, iar expected: not <null> din assertNotNull din JUnit 5.
Am folosit isEqualTo, nu isNotNull. De ce primesc acest mesaj?
Multe aserțiuni AssertJ verifică întâi că valoarea nu e null. Dacă era, primești acest mesaj înaintea comparației propriu-zise.
Erori înrudite
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. java.lang.AssertionError: Expecting ArrayList: ["Mouse", "Tastatură"] to contain: ["Monitor"] but could not find the following element(s): ["Monitor"] O aserțiune AssertJ contains(...) a căutat în colecție un element care nu există acolo. Fie datele testului nu conțin elementul, fie codul nu-l adaugă, fie equals nu se potrivește (compari obiecte fără equals sau texte cu altă formă). Mesajul arată colecția reală: compar-o cu ce aștepți. 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. Î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.
