JSON Schema 날짜 형식 검수, 잘못된 시각이 통과하는 이유
JSON Schema의 날짜 형식 검수는 옵션과 검사기 지원을 함께 확인합니다. 가상 8조건으로 기본 설정과 활성 검사를 비교하고 잘못된 시각·누락·타입 오류의 인수 기준을 정리합니다.
이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스
JSON Schema의 date-time 표기만으로 날짜 검사를 보장하지 않습니다. 2026-11-20 확인 기준, 검증기의 옵션과 날짜 검사기 지원까지 대조해야 합니다.
업무 에이전트가 받은 기한 값에 25시가 들어 있는데 스키마 검사는 통과했습니다. 스키마 파일에 format: "date-time"이 있어도 이런 결과가 나올 수 있습니다. 이 글은 비공개 문의나 실제 장애 사례가 아닌 가상 입력으로, 검증기가 수행한 검사의 범위를 확인합니다.
date-time이 있는데 왜 오류를 거절하지 않나요?#
JSON Schema 2020-12는 형식 정보를 남기는 Format-Annotation과 형식을 검증하는 Format-Assertion을 구별합니다. 기본 메타스키마에 날짜 형식을 적었다는 사실과 구현이 그 형식을 거절 조건으로 사용한다는 사실은 따로 확인해야 합니다. Format-Assertion의 지원도 모든 구현에 필수인 것은 아닙니다. 2020-12의 format 동작
Python jsonschema의 공식 문서는 기본적으로 format 검사를 강제하지 않으며, 검증기에 형식 검사기를 연결하는 방법을 설명합니다. 따라서 구조가 맞는 문자열이 형식 검사 없이 통과할 수 있습니다. 이를 곧바로 스키마 엔진의 결함으로 판단하기 전에 실제 설정을 확인합니다. 공식 형식 검증 안내
MCP 2026-07-28의 도구 입력·출력 스키마도 별도 표기가 없으면 JSON Schema 2020-12를 사용합니다. 다만 structuredContent는 서버가 만든 결과 데이터입니다. 도구 스키마를 검사하는 것과 모델이 생성한 출력의 제약을 같은 기능으로 해석하지 않습니다. 각 서버·클라이언트의 검증 설정은 실제 배포에서 대조해야 합니다. MCP Tools 원문
같은 스키마로 어떤 표본을 비교하나요?#
같은 입력을 기본 검증기와 날짜 검사기를 활성화한 검증기에 각각 넣어 봅니다. 다음은 합성 8조건의 실행 결과입니다. 활성 환경은 Python jsonschema 4.26.0에 FormatChecker를 연결하고 date-time 의존성인 rfc3339-validator 0.1.4가 등록된 상태입니다.
| 가상 deadline 입력 | 기본 검증 | 날짜 검사 활성 |
|---|---|---|
| 2026-11-20T09:00:00Z | 통과 | 통과 |
| 2026-11-20T09:00:00+09:00 | 통과 | 통과 |
| 2026-11-20T25:00:00Z | 통과 | 거절 |
| 2026-02-30T09:00:00Z | 통과 | 거절 |
| 2026-11-20T09:00:00 | 통과 | 거절 |
| not-a-date | 통과 | 거절 |
| deadline 필드 누락 | 거절 | 거절 |
| deadline 값이 숫자 123 | 거절 | 거절 |
사용한 스키마는 다음과 같습니다. 날짜가 빠진 경우는 required, 숫자인 경우는 type에서 거절합니다. 형식 검사 활성화는 이 스키마 문자열을 바꾸는 작업과 구분합니다.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"deadline": {"type": "string", "format": "date-time"}
},
"required": ["deadline"],
"additionalProperties": false
}
Python 예시는 Draft202012Validator(schema, format_checker=FormatChecker())로 검사기를 연결합니다. 이 설정을 다른 언어의 검증기에 그대로 적용할 수는 없으므로, 사용 중인 구현의 형식 검사 옵션을 확인하고 같은 정상·오류 표본으로 대조합니다.
FormatChecker만 연결하면 충분하다는 반론은 어떨까요?#
검사 객체뿐 아니라 필요한 의존성과 지원 형식을 확인해야 합니다. 공식 문서는 일부 형식에 추가 의존성이 필요하며, 필요한 의존성이 없으면 오류 없이 통과할 수 있다고 설명합니다. 설치는 공식 문서의 jsonschema[format] 또는 jsonschema[format-nongpl] 방식과 환경의 의존성 정책을 대조합니다. 배포 환경에서 date-time 검사기가 실제 등록됐는지 확인하고, 등록되지 않았다면 검수 완료로 처리하지 않는 조건을 둡니다. 의존성과 지원 형식
이번 별도 점검에서도 date-time 의존성이 없는 환경은 검사 객체를 연결해도 25시 문자열을 통과시켰습니다. 위 표는 필요한 검사기가 등록된 환경에 한정한 결과입니다. FormatChecker를 연결했다는 이유만으로 Format-Assertion vocabulary 전체를 구현했다고 주장하지 않습니다.
형식이 맞아도 업무 기한이 적절하다는 뜻은 아닙니다. 기한이 과거인지, 어느 영업일의 마감인지, 사용자가 그 기한을 바꿀 권한이 있는지는 별도 업무 규칙입니다. 자연어 ‘내일’을 해석하는 문제는 영업 메일 기한 추출 검수, 예외 코드와 근거 필드의 동반 여부는 JSON Schema 동반 필드 검수에서 구분해 볼 수 있습니다.
어떤 판본과 회사 설명을 근거로 삼았나요?#
2026-11-20에 JSON Schema 2020-12 Validation의 2022-06-16 공개 문서, Python jsonschema 4.26.0 공식 문서, MCP 2026-07-28 판본을 대조했습니다. Python 문서의 개별 게시일은 미표기입니다. 오래된 규칙을 이번 확인일에 새로 발표된 기능으로 소개하지 않습니다.
이 글의 date-time 표본은 RFC 3339 §5.6의 날짜·시각·오프셋 문법을 기준으로 합니다. RFC 공개일은 2002-07이며 확인일은 2026-11-20입니다. 모든 타임스탬프 확장이나 업무 일정 규칙을 이 표가 다룬다는 뜻은 아닙니다. 스키마 방언·검증기·옵션·의존성·업무 의미가 바뀌면 표본을 다시 실행합니다.
알파카랩스의 온톨로지 구축 서비스는 출처·권한을 지키는 AI·MCP 조회와 정답·오답·거절·근거 부족 표본의 검수 협의를 설명합니다. 2026-11-20에 확인한 공개 자기표기이며 최초 게시일은 미표기입니다. 이 글의 날짜 검증 정책을 특정 제품 기능이나 고객 성과로 제시하지 않습니다.
자주 묻는 질문#
date-time을 적었으면 날짜 검사를 했다고 볼 수 있나요?
스키마 표기만으로 판단하지 않습니다. 스키마 방언과 검증기의 형식 검사 설정을 확인하고, 잘못된 날짜를 실제로 거절하는지 대조합니다.
날짜 검사기를 켰는데도 통과하면 무엇을 확인하나요?
해당 형식의 검사기 등록과 추가 의존성을 확인합니다. 지원하지 않는 형식이 조용히 통과하는지 오류 표본으로 대조하고, 검사 지원이 없으면 인수 완료를 보류하는 조건을 둡니다.
기한 필드가 없거나 숫자일 때도 format 문제인가요?
이 글의 스키마에서는 누락은 required, 숫자는 type의 검수 대상입니다. 날짜 문자열의 형식 검사와 구별해 오류 원인을 기록합니다.
과거 기한도 date-time 검사에서 거절하나요?
형식이 맞는 과거 시각은 별도 업무 규칙의 대상입니다. 현재 시점·영업일·마감 기준에 따른 허용 여부를 형식 검사와 따로 검수합니다.
이 표를 다른 언어와 MCP 클라이언트에도 적용할 수 있나요?
정상·오류 표본은 재사용할 수 있지만 판정 결과를 일반화하지 않습니다. 각 구현의 판본·옵션·지원 형식과 의존성을 고정하고 실제 결과를 비교해야 합니다.
날짜 형식 인수표는 어떻게 준비하나요?#
비식별 스키마와 정상·오류 입력, 실제 검증기 버전·옵션·의존성 정보를 함께 준비합니다. 필드 누락·타입·날짜 문법·업무 기한의 오류를 나눠 기록하면, 통과가 어떤 검사를 수행했다는 뜻인지 개발사와 같은 기준으로 확인할 수 있습니다.
날짜 검사의 실행 조건을 정리합니다
첫 범위 협의에서 비식별 스키마·입력·검증 설정을 대조해 날짜 형식 인수표 초안을 정리합니다. 소요 시간은 판본·실행 환경·표본 범위를 확인한 뒤 안내합니다.
날짜 형식 인수표 초안 협의