Java更新API中DOB字段误判更新及日期格式问题排查

在Java开发的更新API中，原本仅需记录实际发生更新的字段，但发现DOB（出生日期，Date类型）无论是否真的被修改，每次都会被标记为更新字段：

• 当请求载荷传入{"DOB": "1990-01-01"}时，日志显示DOB值为Mon Jan 01 05:30:00 IST 1990，且被标记为更新字段，即使该值未发生变化。
• 当传入格式为"DOB": "20101212"的参数时，日志中DOB显示为Thu Jan 01 11:05:01 IST 1970。

1. Date类型比较的精度问题 #

现有代码用newValue.equals(oldValue)比较日期，但存在以下差异：

• 数据库存储的dob字段（来自OrgEmployeeMap）通常仅精确到年月日，而请求解析后的DOB（来自EmployeeInformation）会被Jackson默认解析成带时区和时分秒的Date对象。
• 即使日期本身相同，时分秒的存在会导致equals判断不相等，从而误判为字段更新。

2. 日期格式解析错误 #

请求传入"20101212"这种无分隔符的日期字符串时，Jackson默认的Date解析器无法识别该格式，解析失败后返回Date的初始值Thu Jan 01 11:05:01 IST 1970（即Epoch时间戳0对应的本地时区时间）。

3. 时区不一致问题 #

数据库存储的日期可能采用UTC时区，而请求解析时使用本地时区（比如IST），导致同一日期被解析成不同的Date对象，equals比较不通过。

1. 统一日期比较逻辑，忽略时分秒 #

修改Updater类的update方法，针对Date类型单独处理，仅比较年月日部分：

public <T> Updater update(String fieldName,
                          Function<EmployeeInformation, T> newValueGetter,
                          Function<OrgEmployeeMap, T> oldValueGetter,
                          BiConsumer<OrgEmployeeMap, T> oldValueSetter) {
    final var newValue = newValueGetter.apply(information);
    final var oldValue = oldValueGetter.apply(existing);
    
    // 针对Date类型单独处理比较逻辑
    if (newValue instanceof Date && oldValue instanceof Date) {
        Date newDate = (Date) newValue;
        Date oldDate = (Date) oldValue;
        // 转换为Calendar，只比较年月日
        Calendar newCal = Calendar.getInstance();
        newCal.setTime(newDate);
        Calendar oldCal = Calendar.getInstance();
        oldCal.setTime(oldDate);
        
        boolean sameDate = newCal.get(Calendar.YEAR) == oldCal.get(Calendar.YEAR)
                && newCal.get(Calendar.MONTH) == oldCal.get(Calendar.MONTH)
                && newCal.get(Calendar.DAY_OF_MONTH) == oldCal.get(Calendar.DAY_OF_MONTH);
        
        if (newValue == null || sameDate) {
            return this;
        }
    } else {
        // 其他类型保持原有逻辑
        if (newValue == null || newValue.equals(oldValue)) {
            return this;
        }
    }
    
    this.updatedFields.add(fieldName);
    oldValueSetter.accept(existing, newValue);
    return this;
}

2. 配置Jackson支持多格式日期解析 #

在EmployeeInformation的DOB字段上指定可接受的日期格式，避免解析错误：

@Data
public class EmployeeInformation {
    // 其他字段...
    
    @JsonProperty(value = "DOB")
    @JsonDeserialize(using = CustomDateDeserializer.class)
    private Date DOB;
}

// 自定义日期反序列化器，支持多种格式
public class CustomDateDeserializer extends StdDeserializer<Date> {
    private static final List<SimpleDateFormat> FORMATS = Arrays.asList(
            new SimpleDateFormat("yyyy-MM-dd"),
            new SimpleDateFormat("yyyyMMdd")
    );

    public CustomDateDeserializer() {
        super(Date.class);
    }

    @Override
    public Date deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        String dateStr = p.getText().trim();
        for (SimpleDateFormat format : FORMATS) {
            try {
                synchronized (format) { // SimpleDateFormat非线程安全，需同步
                    return format.parse(dateStr);
                }
            } catch (ParseException e) {
                continue;
            }
        }
        throw new IOException("无法解析日期格式: " + dateStr);
    }
}

3. 统一时区配置 #

• 数据库存储日期时统一使用UTC时区，避免时区差异导致的Date对象不一致。
• 在Jackson配置中全局设置时区为UTC，确保请求解析后的日期与数据库存储的时区一致：

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        mapper.setTimeZone(TimeZone.getTimeZone("UTC"));
        mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd"));
        return mapper;
    }
}

4. 替换为LocalDate类型（推荐） #

Java 8+的LocalDate是无时区、仅存储年月日的类型，比Date更适合存储出生日期：

• 修改DTO和Model类的字段类型：

// EmployeeInformation DTO
@JsonProperty(value = "DOB")
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate DOB;

// EmployeeMap Model
@Column(name = "dob", nullable = false)
private LocalDate dob;

此时equals方法可直接比较，无需额外处理，同时避免时区和时分秒的问题。

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