Kararsız Testler — Kod Değişmedi, Test Neden Bir Kırmızı Bir Yeşil?

Bir kafede oturuyorsun ve masa arada bir sallanıyor. Altına katlanmış bir peçete koyarsın, sallanma durur. Ama yarın başka biri aynı masaya oturduğunda kısa ayak hâlâ orada olacak.

Neden bazen kırılır?

Kararsız test?Terimin tanımını açflakyKod değişmediği hâlde bazen geçen bazen kalan test. Verdiği bilgiyi yok eder: artık "geçti" ne anlama geliyor bilmezsin.Sebebi neredeyse her zaman üç şeyden biridir: paylaşılan durum, zamanlama (sabit bekleme), ya da test sırası bağımlılığı. Retry eklemek semptomu gizler ve bazen üründeki gerçek bir yarış durumunu örter.Sözlükte gör →, aynı kodla bazen geçen bazen kırılan testtir. Kod değişmediyse, değişen şey testin dışarıdan aldığı bir şeydir.

En sık dört şey: o anki saat, garanti edilmeyen bir sıra (örneğin HashSet), başka bir testin bıraktığı durum ve “100 milisaniye yeter” diye konan bir bekleme.

Her sebebin kendi ilacı

Saati koda bir Clock olarak ver; testte sabit bir saat kullan. Sırası garanti olmayan bir koleksiyonu sırasız karşılaştır.

Her teste taze bir durum ver; buna test yalıtımı?Terimin tanımını açtest yalıtımıHer testin kendi taze durumuyla başlaması; bir testin sonucu başka bir testin bıraktığı veriye ya da çalışma sırasına bağlı olmaz.Sözlükte gör → denir. Asenkron işi sabit süre bekleme; koşul gerçekleşene kadar kısa aralıklarla sor.

Kendin gör

1. Varsayılanla oynat. Kod hiç değişmeden on koşudan sekizi kırmızı. Hangi testin hangi koşuda kırıldığına bak.
2. Yalnızca “tekrar dene”yi aç. On koşunun hepsi yeşil, ama sekiz kırılma gizlendi.
3. Tekrar denemeyi kapat, saat dışında her şeyi düzelt. Yalnızca 7. koşu kırmızı: gece yarısı.
4. Dördünü de düzelt. On koşu yeşil, hiçbir şey tekrar denenmedi.

Tuzaklar

Kararsız testi silmek ya da kapatmak. Test bir şeyi koruyordu. Önce sebebini bul; gerekiyorsa kısa süreliğine karantinaya al ama bir sahibi ve bir tarihi olsun.

Yerelde hep geçtiği için CI’ı suçlamak. CI makinesi daha yavaş, saat dilimi farklı, testler başka sırada. Bu farklar sebebi gösterir.

Testleri hep aynı sırada çalıştırmak. Paylaşılan durum gizli kalır. Sırayı karıştırınca sorun erken ve tekrarlanabilir şekilde ortaya çıkar.

1
@Service
2
class InterestService {
3

4
    private final Clock clock;
5
    private final RateTable rates;
6

7
    // Spring injects the system clock; a test passes a fixed one.
8
    InterestService(Clock clock, RateTable rates) {
9
        this.clock = clock;
10
        this.rates = rates;
11
    }
12

13
    BigDecimal dailyInterest(BigDecimal balance) {
14
        LocalDate today = LocalDate.now(clock);
15
        return balance.multiply(rates.dailyRateOn(today)).setScale(2, RoundingMode.HALF_EVEN);
16
    }
17
}

1
class InterestServiceTest {
2

3
    private static final ZoneId ISTANBUL = ZoneId.of("Europe/Istanbul");
4

5
    @Test
6
    void usesTheRateOfTheDayEvenOneSecondBeforeMidnight() {
7
        Clock lateNight = Clock.fixed(LocalDateTime.of(2026, 10, 3, 23, 59, 59).atZone(ISTANBUL).toInstant(), ISTANBUL);
8
        RateTable rates = day -> day.equals(LocalDate.of(2026, 10, 3)) ? new BigDecimal("0.0001") : BigDecimal.ZERO;
9

10
        BigDecimal interest = new InterestService(lateNight, rates).dailyInterest(new BigDecimal("10000"));
11

12
        assertThat(interest).isEqualByComparingTo("1.00");
13
    }
14
}

1
class StatementJobTest {
2

3
    private InMemoryOutbox outbox;
4
    private StatementJob job;
5

6
    @BeforeEach
7
    void freshState() {   // no static list shared with other tests
8
        outbox = new InMemoryOutbox();
9
        job = new StatementJob(outbox, Executors.newVirtualThreadPerTaskExecutor());
10
    }
11

12
    @Test
13
    void sendsOneStatementPerAccount() {
14
        job.runFor(List.of("TR01", "TR02"));
15

16
        // Wait for the condition, not for a guess like Thread.sleep(100).
17
        await().atMost(Duration.ofSeconds(5))
18
                .untilAsserted(() -> assertThat(outbox.recipients()).containsExactlyInAnyOrder("TR01", "TR02"));
19
    }
20
}

1
# Run test methods in a different order every time: shared state shows up early, not on a Friday.
2
junit.jupiter.testmethod.order.default=org.junit.jupiter.api.MethodOrderer$Random

Kendini sına