Skip to content

ELOG 025 study day test helper drift

wcorn edited this page Aug 8, 2026 · 2 revisions

ELOG-025: 새벽 4시 이전에만 복습 테스트 16개가 깨진다 (도메인 규칙이 테스트 헬퍼에만 안 따라옴)

항목 내용
분류 🔧 트러블슈팅
날짜 2026-08-08
영역 BE
관련 이슈/PR #1055, #1056 (원인 제공: #1003, #1004)
상태 해결

1. 상황 (Before)

여행 장소 프록시(#1054, 장소·Redis 캐시)를 마무리하며 ./gradlew check를 돌렸더니 16개가 깨졌다. 시각은 2026-08-08 03:36 KST.

766 tests completed, 16 failed

깨진 것이 전부 복습·플래시카드였다. 장소 작업과 스치는 부분이 하나도 없다.

테스트 클래스 실패
TodayReviewsControllerTest 8
FlashcardControllerTest 4
ReviewMirrorIntegrationTest 4

증상은 한결같이 "오늘 할 복습이 비어 있다"였다.

AssertionError: No value at JSON path "$.data.reviews[0].flashcard.id"
Caused by: PathNotFoundException: No results for path: $['data']['reviews'][0]['flashcard']['id']

내 변경이 원인인지부터 끊었다. 작업을 stash하고 깨끗한 main에서 같은 테스트를 돌렸다.

8 tests completed, 8 failed   ← 내 변경 없이도 동일

내 것이 아니었다. main에 이미 있던 문제다.

2. 원인 분석

ApiTestSupport.testToday()가 달력 날짜를 돌려주고 있었다.

/** 사용자 시간대(Asia/Seoul) 기준 오늘 날짜. */
protected static LocalDate testToday(Clock clock) {
    return clock.instant().atZone(TEST_ZONE).toLocalDate();
}

그런데 앱이 보는 "오늘"은 자정 기준이 아니다. #1004(2026-08-02)에서 학습일 경계를 04:00으로 옮겼다.

/** 그 시각이 속한 학습일. 자정~04:00은 전날로 친다. */
public static LocalDate of(Instant instant, ZoneId zone) {
    return instant.atZone(zone).minusHours(ROLLOVER_HOUR).toLocalDate();
}

새벽 1시에 공부한 건 사용자에겐 "어젯밤 공부"라서, 자정을 경계로 삼으면 첫 복습이 하루 밀린다(#1003). 그래서 ReviewSchedule에만 있던 경계 상수를 orino-common의 StudyDay로 올려 BE 전체가 같은 경계를 쓰게 했다.

두 경계가 어긋난 시간대에만 깨진다.

실제 시각 (KST) 앱의 학습일 testToday() 일치
08-08 03:36 08-07 08-08 ❌
08-08 04:00 08-08 08-08 ✅
08-08 14:00 08-08 08-08 ✅

깨지는 메커니즘은 이렇다. 테스트는 복습을 today.atTime(4, 0), 즉 학습일이 시작하는 04:00 정각에 심는다.

LocalDate today = testToday(clock);
reviewScheduleRepository.save(new ReviewSchedule(
        member.getId(), card.getId(), 1, atTestZone(today.atTime(4, 0)), 1, ...));

03:36에 돌리면 testToday()가 08-08을 주므로 복습이 08-08 04:00에 심긴다. 그런데 그 시각 앱의 학습일은 아직 08-07이다. 즉 방금 심은 복습은 내일 몫이고, "오늘 할 복습" 목록에서 전부 빠진다 → 빈 배열.

한 군데 더 있었다. ReviewMirrorIntegrationTest는 헬퍼를 안 쓰고 같은 식을 인라인으로 복사해 갖고 있었다.

today = clock.instant().atZone(TEST_ZONE).toLocalDate();   // 헬퍼와 같은 계산의 사본

헬퍼만 고쳤으면 이 4개는 그대로 깨진 채 남았다.

왜 6일이나 안 드러났나. testToday()는 #435(2026-06-03)부터 있었고, #1004는 프로덕션 코드를 넓게 훑었다 — 커밋 메시지에 "적용: 다음 복습 날짜, 첫 복습, 밀린 일수, 짝 카드 미루기, 오늘 복습, 허브 현황, 오늘 완료 수와 밀림 경계, 카드 목록 복습 창"에 FE까지 열거돼 있다. 그 스윕에 테스트 지원 계층만 빠졌다.

재현 창은 KST 00:00~04:00, 하루 4시간이다. CI는 UTC로 도니 매일 18:00~22:00 UTC가 같은 창이다. 그 창 안에서 빌드가 돌아야만 드러나는데, 하필 그 시간에 빌드를 돌린 게 이날이었다.

3. 조치 (PR #1056)

헬퍼를 앱과 같은 경계로 맞췄다.

/**
 * 앱이 "오늘"로 보는 학습일(Asia/Seoul, 04시 롤오버).
 *
 * <p>달력 날짜를 쓰면 자정~04:00 사이에 돌릴 때만 하루 어긋나 테스트가 깨진다 —
 * 그 시간대엔 앱이 아직 전날을 오늘로 보기 때문이다({@link StudyDay}).
 */
protected static LocalDate testToday(Clock clock) {
    return StudyDay.of(clock.instant(), TEST_ZONE);
}

ReviewMirrorIntegrationTest의 인라인 사본은 지우고 공용 헬퍼로 통일했다. 사본이 남아 있으면 다음에 경계가 또 바뀔 때 같은 일이 반복된다.

프로덕션 코드는 한 줄도 안 바꿨다. 로직은 원래 맞았고, 틀린 것은 테스트였다.

여행 작업(#1054)과 무관하므로 별도 이슈·PR로 분리했다. 남의 PR에 섞으면 리뷰에서 "왜 이 변경이 여기 있나"가 되고, 되돌릴 때도 엉킨다.

4. 결과 (After)

같은 시각(03:36 KST)에 다시 돌려 확인했다 — 시간을 바꿔 통과시킨 게 아니다.

Before After
TodayReviewsControllerTest 8 failed ✅
FlashcardControllerTest 4 failed ✅
ReviewMirrorIntegrationTest 4 failed ✅
./gradlew check 전체 16 failed / 766 BUILD SUCCESSFUL

이후 여행 작업 PR들(#1057, #1060, #1062, #1064)의 CI도 전부 초록으로 돌았다.

5. 교훈 / 후속

  • 시간에 의존해 깨지는 테스트는 "가끔 깨지는 테스트"가 아니라 틀린 규칙을 담고 있는 테스트다. 재시도하거나 @Disabled를 붙일 일이 아니었다. 실제로 깨진 16개 전부가 "앱의 오늘"과 "테스트의 오늘"이 다르다는 한 가지 사실을 정직하게 알려주고 있었다.
  • 도메인 개념을 옮기거나 바꿀 때 스윕 대상에 테스트 지원 계층을 넣는다. #1004는 프로덕션과 FE까지 훑었지만 support/를 빼먹었다. 테스트 헬퍼도 같은 규칙을 인코딩한 코드다.
  • 테스트 안의 도메인 계산 사본은 조용히 드리프트한다. ReviewMirrorIntegrationTest의 인라인 복사가 정확히 헬퍼가 존재하는 이유였는데, 그걸 안 쓰고 있었다. 헬퍼만 고쳤다면 4개는 계속 빨갰다.
  • 모르는 실패를 보면 내 브랜치를 의심하기 전에 main을 찍어 본다. stash 후 깨끗한 main에서 재현한 덕에 원인 탐색 범위가 장소 코드 전체에서 헬퍼 한 줄로 좁혀졌다.
  • "오늘"을 계산하는 코드는 경계에서 테스트해야 한다. 하루 중 어느 시각에 빌드를 돌리느냐에 따라 결과가 달라지는 테스트는, 사실상 그 시각을 테스트 입력으로 쓰면서 명시하지 않은 것이다.
  • 후속(#1065): 복습 테스트가 주입받는 Clock을 01:00 KST로 고정한 케이스를 추가하면 이 창을 벽시계와 무관하게 상시 검증할 수 있다. 지금은 04시 이후에 돌리면 경계를 아예 안 지난다 — 즉 같은 드리프트가 또 생겨도 새벽에 빌드를 돌리는 사람이 있어야만 드러난다.

참고

  • PR #1056, 이슈 #1055 / 후속 이슈 #1065
  • 원인 제공: PR #1004 (학습일 경계 04:00 통일), 이슈 #1003
  • 헬퍼 최초 도입: PR #435 (datetime UTC 저장 + 사용자 시간대 반환)
  • Test Strategy

Clone this wiki locally