networknt json-schema-validator日期时间格式验证失败问题求助

问题根源 #

生成POJO时，日期字段的序列化输出格式未严格匹配JSON Schema要求的RFC3339标准格式（通常是缺少时区信息或格式语法错误），导致验证时触发格式不匹配错误。

解决步骤 #

1. 修正POJO日期字段的序列化配置 #

如果使用Jackson序列化，给日期字段添加@JsonFormat注解，指定严格的RFC3339格式，并使用带时区的日期类型：

import com.fasterxml.jackson.annotation.JsonFormat;
import java.time.OffsetDateTime;

public class YourPojo {
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSXXX")
    private OffsetDateTime datetime;

    // getter/setter
}

• 优先使用OffsetDateTime或ZonedDateTime，避免LocalDateTime（后者无时区信息，不符合RFC3339要求）。

2. 确认JSON Schema的日期字段定义 #

确保Schema中datetime字段的类型和格式声明正确：

{
  "type": "object",
  "properties": {
    "datetime": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": ["datetime"]
}

3. 全局调整序列化规则（可选） #

如果需要统一处理所有日期字段，配置Jackson全局序列化规则：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import java.text.SimpleDateFormat;

ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JavaTimeModule());
// 禁用时间戳序列化，强制输出字符串格式
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
// 指定RFC3339格式
mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSXXX"));

4. 修正JUnit测试逻辑 #

确保验证的是POJO序列化后的JSON字符串，而非POJO对象本身：

@Test
void testPojoAgainstSchema() throws Exception {
    // 1. 生成POJO实例
    YourPojo pojo = new YourPojo();
    pojo.setDatetime(OffsetDateTime.now());

    // 2. 序列化为JSON字符串
    ObjectMapper mapper = new ObjectMapper();
    mapper.registerModule(new JavaTimeModule());
    mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
    String json = mapper.writeValueAsString(pojo);

    // 3. 用JSON Schema验证该字符串
    JsonSchema schema = JsonSchemaFactory.getInstance().getSchema(schemaFile);
    Set<ValidationMessage> errors = schema.validate(json);
    assertTrue(errors.isEmpty());
}

内容的提问来源于stack exchange，提问作者Patrick Rode