MAX(CONVERT(column, TIME(3)))在MySQL客户端与JPA原生查询返回值不一致

问题现象 #

• 在MySQL客户端执行MAX(CONVERT(column, TIME(3)))，能正确返回超过24小时的时间值47:40:00.000
• 但通过JPA原生查询执行相同语句，返回值被截断为23:40:00

根因分析 #

• MySQL的TIME类型支持存储-838:59:59到838:59:59范围的时长，允许超过24小时的数值
• JPA默认通过JDBC驱动将MySQL的TIME类型映射到Java的java.sql.Time类，而java.sql.Time仅能表示00:00:00到23:59:59的一天内时间，超出部分会被自动截断

解决方案 #

方案1：返回字符串类型 #

修改原生查询，将时间转换为字符串格式返回，避免JDBC的类型转换截断：

SELECT MAX(CONVERT(column, CHAR(12))) FROM your_table;

JPA端以String类型接收结果，可完整保留47:40:00.000这类超过24小时的时间值。

方案2：映射为Java Duration类型 #

自定义JPA类型转换器，将MySQL的TIME值映射为Java的Duration类（适合处理时长场景）：

@Converter(autoApply = true)
public class MySQLTimeToDurationConverter implements AttributeConverter<String, Duration> {
    @Override
    public Duration convertToDatabaseColumn(String attribute) {
        if (attribute == null) return null;
        // 将"HH:mm:ss.SSS"格式转换为Duration
        String[] parts = attribute.split("[:.]");
        long hours = Long.parseLong(parts[0]);
        long minutes = Long.parseLong(parts[1]);
        long seconds = Long.parseLong(parts[2]);
        long millis = parts.length > 3 ? Long.parseLong(parts[3]) : 0;
        return Duration.ofHours(hours).plusMinutes(minutes).plusSeconds(seconds).plusMillis(millis);
    }

    @Override
    public String convertToEntityAttribute(Duration dbData) {
        if (dbData == null) return null;
        // 将Duration转换回"HH:mm:ss.SSS"格式
        return String.format("%02d:%02d:%02d.%03d",
                dbData.toHours(),
                dbData.toMinutesPart(),
                dbData.toSecondsPart(),
                dbData.toMillisPart());
    }
}

也可以在查询时直接计算总秒数，再在Java端转换：

SELECT MAX(TIME_TO_SEC(column)) FROM your_table;

接收后用Duration.ofSeconds(查询结果)转换为时长对象。

方案3：调整JDBC驱动参数 #

部分MySQL JDBC驱动版本支持通过参数禁用时间截断，比如添加连接参数：

jdbc:mysql://localhost:3306/db?useLegacyDatetimeCode=false&useTimezone=false

但该方式依赖驱动版本，兼容性不如前两种方案，需自行测试验证。

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