SpringBoot JPA保存时间到PostgreSQL时移除时区后缀+07

问题本质 #

你用@Temporal(TemporalType.TIME)搭配java.util.Date时，JPA会默认将Date对象转换为带时区的时间格式（如HH:mm:ss+07），而数据库列是VARCHAR类型，所以最终存储的是带时区后缀的字符串。以下是三种可行的解决办法：

方案1：直接用String类型存储时间字符串 #

修改实体字段类型为String，移除@Temporal注解，业务层确保传入的是纯HH:mm:ss格式的字符串：

@Column(name = "pickup_schedule")
private String customPickupTm;

这种方式最直接，完全规避JPA的时间类型转换逻辑，直接存储你需要的格式。

方案2：自定义属性转换器（保留Date类型） #

如果不想修改字段类型，通过JPA的AttributeConverter自定义Date与字符串的转换规则，强制输出HH:mm:ss格式：

Java 8+ 版本（推荐，线程安全）

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.util.Date;
import java.time.Instant;
import java.time.ZoneId;

@Converter(autoApply = false)
public class TimeToStringConverter implements AttributeConverter<Date, String> {
    private static final DateTimeFormatter TIME_FORMATTER = DateTimeFormatter.ofPattern("HH:mm:ss");
    private static final ZoneId DEFAULT_ZONE = ZoneId.systemDefault();

    @Override
    public String convertToDatabaseColumn(Date date) {
        if (date == null) return null;
        LocalTime localTime = date.toInstant().atZone(DEFAULT_ZONE).toLocalTime();
        return localTime.format(TIME_FORMATTER);
    }

    @Override
    public Date convertToEntityAttribute(String dbData) {
        if (dbData == null || dbData.isEmpty()) return null;
        LocalTime localTime = LocalTime.parse(dbData, TIME_FORMATTER);
        return Date.from(localTime.atDate(java.time.LocalDate.now()).atZone(DEFAULT_ZONE).toInstant());
    }
}

然后在实体字段上添加@Convert注解：

@Column(name = "pickup_schedule")
@Convert(converter = TimeToStringConverter.class)
private Date customPickupTm;

旧版本Java（注意线程安全问题）

若使用Java 8之前的版本，用SimpleDateFormat实现，但需注意它不是线程安全的，建议在方法内创建实例：

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;
import java.text.SimpleDateFormat;
import java.util.Date;

@Converter(autoApply = false)
public class TimeToStringConverter implements AttributeConverter<Date, String> {
    @Override
    public String convertToDatabaseColumn(Date date) {
        if (date == null) return null;
        return new SimpleDateFormat("HH:mm:ss").format(date);
    }

    @Override
    public Date convertToEntityAttribute(String dbData) {
        if (dbData == null || dbData.isEmpty()) return null;
        try {
            return new SimpleDateFormat("HH:mm:ss").parse(dbData);
        } catch (Exception e) {
            throw new IllegalArgumentException("Invalid time format: " + dbData, e);
        }
    }
}

方案3：修改数据库列类型为TIME（不带时区） #

如果业务允许修改数据库结构，将pickup_schedule列的类型从VARCHAR改为PostgreSQL的TIME类型（不带时区），实体字段保留原注解：

@Column(name = "pickup_schedule")
@Temporal(TemporalType.TIME)
private Date customPickupTm;

PostgreSQL的TIME类型存储的是纯时间值，不会带时区后缀，查询时若需要字符串格式，可通过TO_CHAR(pickup_schedule, 'HH24:MI:SS')转换。

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