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

java.lang.AssertionError: Expecting actual not to be null

Pe scurt

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

Greșit
JAVA
ClientDto inDto(Client c) {
    return new ClientDto(c.getId(), c.getNume(), null);
}
Corect
JAVA
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ă

Greșit
JAVA
@SpringBootTest
class ClientMapperTest {
    ClientMapper mapper;
}
Corect
JAVA
@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

Greșit
JAVA
assertThat(repo.findByEmail("ana@exemplu.ro")).isNotNull();
// baza e goală în acest test
Corect
JAVA
repo.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ă tu

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.

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.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");
    }
}
După reparație, programul afișează
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.

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

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