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

org.junit.platform.commons.JUnitException: @BeforeAll method 'void CosServiceTest.pregateste()' must be static unless the test class is annotated with @TestInstance(Lifecycle.PER_CLASS).

Pe scurt

JUnit 5 rulează metodele @BeforeAll o singură dată, înainte să creeze vreo instanță a clasei de test, deci ele trebuie să fie static. Fă metoda static (și câmpurile pe care le setează), sau pune @TestInstance(Lifecycle.PER_CLASS) pe clasă.

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

Ce înseamnă

JUnit 5 creează implicit o instanță nouă a clasei de test pentru fiecare metodă @Test. Metodele @BeforeAll și @AfterAll rulează o singură dată pentru toată clasa, înaintea primei instanțe, deci nu au pe ce obiect să fie apelate dacă nu sunt static. JUnit verifică asta la descoperirea testelor și oprește clasa cu @BeforeAll method 'void CosServiceTest.pregateste()' must be static unless the test class is annotated with @TestInstance(Lifecycle.PER_CLASS).

Eroarea apare des la trecerea de la JUnit 4 (@BeforeClass, tot static) sau când vrei ca @BeforeAll să folosească un bean injectat cu @Autowired, care este câmp de instanță.

Ai două variante: metoda și câmpurile pe care le inițializează devin static, sau declari @TestInstance(TestInstance.Lifecycle.PER_CLASS) pe clasă, ca JUnit să folosească o singură instanță pentru toate testele. Pentru pregătiri care trebuie refăcute înaintea fiecărui test, folosește @BeforeEach, care nu cere static.

De ce apare: cauzele frecvente

1Metoda nu e static

Greșit
JAVA
@BeforeAll
void pregateste() {
    preturi = List.of(89, 199);
}
Corect
JAVA
@BeforeAll
static void pregateste() {
    preturi = List.of(89, 199);
}

Metoda statică poate rula fără instanță; câmpul preturi trebuie să fie și el static.

2Ai nevoie de un bean injectat

Greșit
JAVA
@Autowired CosService cos;
@BeforeAll
void incalzeste() { cos.total(List.of()); }
Corect
JAVA
@TestInstance(TestInstance.Lifecycle.PER_CLASS)
class CosServiceTest {
    @Autowired CosService cos;
    @BeforeAll
    void incalzeste() { cos.total(List.of()); }
}

Cu o singură instanță pe clasă, @BeforeAll poate fi metodă de instanță.

3Pregătirea trebuie refăcută la fiecare test

Greșit
JAVA
@BeforeAll
void golesteCosul() { cos.goleste(); }
Corect
JAVA
@BeforeEach
void golesteCosul() { cos.goleste(); }

@BeforeEach rulează înaintea fiecărui test și nu cere static.

Repară tu

Repară eroarea, direct în pagină

Clasa de test nu rulează: @BeforeAll method 'void CosServiceTest.pregateste()' must be static. Fă metoda pregateste și câmpul preturi statice, ca testul să ruleze și să treacă.

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
class CosServiceTest {
    @Autowired
    CosService cos;

    List<Integer> preturi;

    @BeforeAll
    void pregateste() {
        preturi = List.of(89, 199, 35);
    }

    @Test
    void totalulCosului() {
        assertEquals(323, cos.total(preturi));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
CosServiceTest
  OK    totalulCosului()
Teste: 1 trecute, 0 picate
Indiciu

Și metoda, și câmpul pe care îl setează trebuie să fie static.

Alte forme ale mesajului

  • @AfterAll method 'void CosServiceTest.curata()' must be static unless the test class is annotated with @TestInstance(Lifecycle.PER_CLASS).

Cum o eviți pe viitor

  • Folosește @BeforeEach pentru majoritatea pregătirilor; @BeforeAll doar pentru lucruri scumpe și imuabile.
  • Când ai nevoie de @BeforeAll cu bean-uri Spring, adaugă @TestInstance(PER_CLASS).
  • Nu partaja stare modificabilă între teste prin câmpuri statice.
  • La migrarea de la JUnit 4, înlocuiește @BeforeClass cu @BeforeAll static.

Întrebări frecvente

Care e diferența dintre @BeforeAll și @BeforeEach?

@BeforeAll rulează o dată pe clasă, înaintea tuturor testelor; @BeforeEach înaintea fiecărui test. Pentru izolare, preferă @BeforeEach.

Pot folosi @TestInstance(PER_CLASS) peste tot?

Poți, dar testele împart aceeași instanță și deci câmpurile; un test poate lăsa stare pentru următorul. Folosește-l când chiar ai nevoie.

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.