SOFTMOA TECHNOLOGY

Spring cron 6개 필드 오류와 매초 실행, 초 필드 확인 방법

소프트모아가 정리한 기술 기록입니다.

Contents
작성일 2026. 11. 15.

Spring @Scheduled에 cron 식을 넣었는데 6개 필드가 필요하다는 오류가 나면 맨 앞의 초 필드를 확인합니다. 별표 하나를 붙이는 것으로는 부족합니다. 매일 13:15에 한 번을 의도했다면 0 15 13 * * *입니다. * 15 13 * * *는 그 분의 매초와 일치하므로 문법 검사를 통과해도 의도와 다릅니다. 필드 수를 맞춘 뒤 다음 두 일치 시각까지 비교하는 편이 안전합니다.[1][2]

오류가 사라져도 초 필드를 다시 봅니다

Spring cron의 일반 표현식은 왼쪽부터 초·분·시·일·월·요일, 총 6개 필드입니다. 15 13 * * *처럼 5개만 넘기면 파싱에 실패합니다. 초 자리에 쓰는 0은 0초만, *는 해당 필드의 모든 값을 가리킵니다. 여기서 확인하려는 것은 작업 등록 방법이 아니라, 이미 넣은 식이 원하는 시각을 뜻하는지입니다.[1]

  • 15 13 * * *: 필드 부족으로 거절됩니다.
  • * 15 13 * * *: 13:15:00 다음에도 13:15:01이 일치합니다.
  • 0 15 13 * * *: 13:15:00 다음 일치는 다음 날 13:15:00입니다.

작업을 실행하지 않고 다음 시각만 계산하기

아래는 Spring Framework 6.2.12와 Temurin JDK 25.0.4.1에서 실행한 진단 코드입니다. Spring 컨텍스트를 띄우거나 예약 작업을 등록하지 않고 CronExpression.parse와 next만 호출합니다. 날짜는 재현용으로 고정했습니다. 실제 알림 발송이나 DB 갱신을 붙이지 말고, 사용 중인 프로젝트의 테스트 환경에서 식부터 확인하세요.[1]

import java.time.ZonedDateTime;
import org.springframework.scheduling.support.CronExpression;

public class CronCheck {
    public static void main(String[] args) {
        var base = ZonedDateTime.parse("2026-11-15T13:14:59+09:00[Asia/Seoul]");
        for (String value : new String[]{"15 13 * * *", "* 15 13 * * *", "0 15 13 * * *"}) {
            try {
                var cron = CronExpression.parse(value);
                var first = cron.next(base);
                var second = first == null ? null : cron.next(first);
                System.out.println(value + " => " + first + " / " + second);
            } catch (IllegalArgumentException e) {
                System.out.println(value + " => " + e.getMessage());
            }
        }
        var daily = CronExpression.parse("0 15 13 * * *");
        var utc = base.withZoneSameInstant(java.time.ZoneId.of("UTC"));
        System.out.println("UTC base => " + daily.next(utc));
    }
}

CronCheck.java로 저장하고 IDE에서 main을 실행하면 됩니다. 명령행에서는 프로젝트가 사용하는 Spring JAR와 의존성이 들어 있는 클래스패스를 CP에 지정한 뒤 아래처럼 실행합니다. 이 글의 검증은 같은 버전의 spring-context, spring-core, spring-jcl을 사용했습니다. 운영 프로젝트의 의존성 버전을 이 예시에 맞춰 바꾸지는 마세요.

java -version
java -cp "$CP" CronCheck.java

실제 출력은 다음과 같습니다. 초가 0인 시각은 문자열에서 :00이 생략돼 있습니다.

15 13 * * * => Cron expression must consist of 6 fields (found 5 in "15 13 * * *")
* 15 13 * * * => 2026-11-15T13:15+09:00[Asia/Seoul] / 2026-11-15T13:15:01+09:00[Asia/Seoul]
0 15 13 * * * => 2026-11-15T13:15+09:00[Asia/Seoul] / 2026-11-16T13:15+09:00[Asia/Seoul]
UTC base => 2026-11-15T13:15Z[UTC]

첫 행은 실패이고, 둘째 행은 성공했지만 요구와 어긋난 결과입니다. 셋째 행에서만 다음 일치가 다음 날로 넘어갑니다. 첫 결과 하나만 비교하면 둘째와 셋째를 구분하지 못합니다. next에 첫 결과를 다시 넣는 이유입니다. 다음 일치를 찾지 못하면 이 메서드는 null을 반환합니다. 코드에도 그 경우를 남겼습니다.[1]

13:15가 어느 시간대인지 별도로 정합니다

마지막 출력은 같은 기준 순간을 UTC로 바꿔 계산한 결과입니다. UTC의 13:15를 반환하므로 앞의 한국시간 13:15와 같은 예약 시각이 아닙니다. 이 테스트는 입력한 ZonedDateTime의 시간대를 사용하며, 운영 중인 @Scheduled의 zone 설정을 읽어 오지는 않습니다.

@Scheduled에서 zone을 비워 두면 스케줄러의 기본 시간대를 사용합니다. 한국시간을 요구한다면 해당 메서드의 설정에 아래처럼 명시합니다. 이 설정은 공식 문서 기준 예시이며 이번 진단에서 실제 예약 실행까지 시험한 것은 아닙니다. 스케줄링이 활성화된 Spring 빈의 메서드에 적용한다는 전제입니다.[2]

@Scheduled(cron = "0 15 13 * * *", zone = "Asia/Seoul")

식 수정과 이미 처리한 작업의 복구는 다릅니다

다음 시각 계산은 달력 조건 검사입니다. 그 시각에 프로세스가 살아 있는지, 작업이 언제 끝나는지, DB 저장이 성공하는지까지 보장하지 않습니다. 매초 일치하는 식이라고 실제 업무 처리가 반드시 매초 완료됐다고 집계해서도 안 됩니다. 실행 로그의 시작·종료와 저장 결과를 따로 확인하세요.

식과 시간대를 고쳤더라도 이전 설정으로 발송한 알림이나 생성한 데이터는 그대로 남습니다. 과거 실행 이력은 지우지 말고 실제 중복 처리 여부부터 조사합니다. 한 메서드에 @Scheduled가 여러 개 붙으면 각 선언이 독립적으로 처리된다는 점도 확인 대상입니다.[2] 표현식이 맞아도 중복 실행 방지는 별도 확인 대상입니다.

확인 근거: [1] Spring 6.2.12 CronExpression API, [2] Spring 6.2.12 Scheduled API. 소프트모아의 개발 서비스는 softmoa.com에서 확인할 수 있습니다.

소프트모아는 해당 시스템을 구축합니다. 문의하기

Share this

Spring

Have a questions?

견적 및 기술문의

mobile : 010-7931-4813

Contact Form