Spring Boot 3.2+Hibernate存储LocalTime值异常问题求助

开发者阿泽

2026-7-4

问题原因与解决方案

核心原因

这个问题是数据库TIME类型的精度限制与Hibernate处理极端时间值的逻辑共同导致的：

LocalTime.MAX的实际值是23:59:59.999999999（9位纳秒精度）
绝大多数数据库的TIME类型默认仅支持6位微秒精度（即最大999999纳秒）。当传入超过精度的纳秒值时，数据库会对时间进行向上进位操作：23:59:59.999999999进位后变成24:00:00，而数据库TIME类型的合法范围通常是00:00:00到23:59:59，因此这个超出范围的时间会被自动转换为00:00:00。

你描述里可能存在笔误：应该是存储LocalTime.MAX和LocalTime.MAX.withNano(999_999_999)时出现异常，而LocalTime.MAX.withNano(999_000_000)（值为23:59:59.999000000）刚好落在数据库默认精度范围内，所以能正常存储。

解决方法

1. 修改数据库字段精度

如果你的数据库支持高精度TIME类型（如MySQL 5.6+、PostgreSQL），可以将my_time字段的类型修改为TIME(9)，以支持9位纳秒精度。

2. 配置Hibernate映射

在实体类的myTime字段上显式指定字段定义，确保Hibernate按高精度处理：

@Entity
@Getter
@Setter
public class DummyEntity {

    @Id
    private Long id;
    private String name;
    @Column(columnDefinition = "TIME(9)")
    private LocalTime myTime;
}