Java Spring Boot适配MySQL 8.0+不完整日期的实体类型选型

MySQL 8.0+支持存储'YYYY-00-00'这类不完整DATE值，但Java标准日期类型（如LocalDate）不允许月份/日期为0，以下是两种强类型解决方案，避免使用String类型放松格式约束：

方案一：用YearMonth配合自定义属性转换器 #

YearMonth是Java 8+自带的类型，完美匹配卡片有效期的MM-YYYY业务场景，通过JPA属性转换器实现与MySQL DATE类型的双向映射：

1. 编写转换器类 #

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;
import java.time.YearMonth;
import java.sql.Date;

@Converter(autoApply = true)
public class YearMonthToDateConverter implements AttributeConverter<YearMonth, Date> {

    @Override
    public Date convertToDatabaseColumn(YearMonth yearMonth) {
        if (yearMonth == null) {
            return null;
        }
        // 将YearMonth转为MySQL支持的'YYYY-MM-00'格式
        String dateStr = yearMonth + "-00";
        return Date.valueOf(dateStr);
    }

    @Override
    public YearMonth convertToEntityAttribute(Date dbDate) {
        if (dbDate == null) {
            return null;
        }
        // 截取数据库DATE值的前7位（YYYY-MM）转为YearMonth
        return YearMonth.parse(dbDate.toString().substring(0, 7));
    }
}

2. 实体类定义 #

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import java.time.YearMonth;

@Entity
public class Card {
    @Id
    private String id;

    private String number;

    @Column(columnDefinition = "DATE")
    private YearMonth expiry;

    // 省略getter、setter
}

方案二：直接使用java.sql.Date并封装转换逻辑 #

如果不想用转换器，可以直接用java.sql.Date作为字段类型，同时封装方法实现与YearMonth的转换，避免业务代码直接处理无效日期：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import java.sql.Date;
import java.time.YearMonth;

@Entity
public class Card {
    @Id
    private String id;

    private String number;

    private Date expiry;

    // 对外暴露YearMonth类型的读写方法
    public YearMonth getExpiry() {
        return expiry == null ? null : YearMonth.parse(expiry.toString().substring(0, 7));
    }

    public void setExpiry(YearMonth yearMonth) {
        if (yearMonth == null) {
            this.expiry = null;
            return;
        }
        this.expiry = Date.valueOf(yearMonth + "-00");
    }

    // 禁止直接操作expiry字段的getter/setter，可设置为private
    private Date getExpiryDate() { return expiry; }
    private void setExpiryDate(Date expiry) { this.expiry = expiry; }
}

注意事项 #

• 确保MySQL的sql_mode未启用NO_ZERO_IN_DATE和NO_ZERO_DATE，否则会拒绝存储'YYYY-00-00'格式的值。可通过执行SET sql_mode = '';临时调整，或在配置文件中永久修改。
• 两种方案均使用强类型校验，避免了String类型可能出现的格式错误（如2024/13这类无效值）。

内容的提问来源于stack exchange，提问作者Abhishek Pratap Singh