Repository navigation
ELOG 025 study day test helper drift
| 항목 | 내용 |
|---|---|
| 분류 | 🔧 트러블슈팅 |
| 날짜 | 2026-08-08 |
| 영역 | BE |
| 관련 이슈/PR | #1055, #1056 (원인 제공: #1003, #1004) |
| 상태 | 해결 |
여행 장소 프록시(#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에 이미 있던 문제다.
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가 같은 창이다. 그 창 안에서 빌드가 돌아야만 드러나는데, 하필 그 시간에 빌드를 돌린 게 이날이었다.
헬퍼를 앱과 같은 경계로 맞췄다.
/**
* 앱이 "오늘"로 보는 학습일(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에 섞으면 리뷰에서 "왜 이 변경이 여기 있나"가 되고, 되돌릴 때도 엉킨다.
같은 시각(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도 전부 초록으로 돌았다.
-
시간에 의존해 깨지는 테스트는 "가끔 깨지는 테스트"가 아니라 틀린 규칙을 담고 있는 테스트다. 재시도하거나
@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