MySQL 8与Spring Boot中无毫秒日期比较问题处理

问题背景 #

从MySQL 5升级到8后，datetime字段的毫秒处理逻辑发生变化：MySQL 5会直接截断毫秒，以yyyy-MM-dd HH:mm:ss格式存储；MySQL 8默认会对毫秒四舍五入存储。即使设置sqlmode=TIME_TRUNCATE_FRACTIONAL让数据库截断毫秒，JPA查询时仍会携带毫秒参数去匹配，导致传入2024-07-18 09:39:34.927时，查不到数据库中存储的2024-07-18 09:39:34数据，手动修改每个查询成本太高。

以下是几种配置级的解决方案，无需逐个修改DAO查询：

1. 全局统一截断日期毫秒（JPA/Hibernate层面） #

方式A：自定义全局AttributeConverter #

实现一个JPA属性转换器，自动对所有Date类型字段（标记@Temporal(TemporalType.TIMESTAMP)）截断毫秒，查询和存储时都生效：

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;
import java.sql.Timestamp;
import java.util.Date;

@Converter(autoApply = true) // autoApply=true 让转换器全局生效
public class DateTruncateMillisecondsConverter implements AttributeConverter<Date, Timestamp> {

    @Override
    public Timestamp convertToDatabaseColumn(Date date) {
        if (date == null) {
            return null;
        }
        // 截断毫秒：取整到秒级别
        long truncatedTime = date.getTime() / 1000 * 1000;
        return new Timestamp(truncatedTime);
    }

    @Override
    public Date convertToEntityAttribute(Timestamp timestamp) {
        return timestamp;
    }
}

添加这个类后，所有JPA操作中的Date参数都会自动去掉毫秒，和MySQL 5的行为完全对齐。

方式B：Hibernate原生全局配置（5.4+版本适用） #

如果使用Hibernate 5.4及以上版本，直接在配置文件中添加参数即可，无需编写代码：

# application.properties
# 指定Timestamp类型的精度为截断毫秒
hibernate.type.timestamp_precision=MILLISECOND_TRUNCATED

这个配置会让Hibernate在处理Timestamp类型的查询参数和实体字段时，自动截断毫秒部分。

2. 数据库层面统一日期存储格式 #

直接修改数据库字段类型，明确指定不存储毫秒，从根源对齐MySQL 5的逻辑：

ALTER TABLE TableName MODIFY COLUMN column_a datetime(0) NOT NULL;

datetime(0)表示只保留到秒级，配合之前设置的sqlmode=TIME_TRUNCATE_FRACTIONAL，MySQL会直接截断毫秒存储，彻底避免四舍五入和参数匹配问题。

3. 全局拦截JPA查询参数 #

通过自定义Hibernate查询参数拦截器，对所有Date类型的查询参数自动截断毫秒：

import org.hibernate.query.spi.QueryParameterBindingInterceptor;
import org.hibernate.query.spi.QueryParameterBindings;
import java.util.Date;
import java.sql.Timestamp;

public class TruncateDateParameterInterceptor implements QueryParameterBindingInterceptor {

    @Override
    public void intercept(QueryParameterBindings bindings) {
        bindings.getBindings().forEach((param, binding) -> {
            Object value = binding.getBindValue();
            if (value instanceof Date) {
                Date date = (Date) value;
                long truncatedTime = date.getTime() / 1000 * 1000;
                binding.setBindValue(new Timestamp(truncatedTime));
            }
        });
    }
}

然后在配置文件中注册拦截器：

# application.properties
hibernate.query.parameter_binding_interceptor=com.yourpackage.TruncateDateParameterInterceptor

这个方案会拦截所有Hibernate生成的查询，自动处理Date参数的毫秒截断。

方案选择建议 #

• 优先选方式A的Converter：兼容性好，不依赖特定Hibernate版本，代码简单易维护。
• 若用高版本Hibernate，选方式B的配置：零代码实现，最简洁。
• 若允许修改表结构，选数据库层面修改：从根源解决问题，后续无需担心代码层面的兼容。

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