JPA持久化LocalDate字段查询报错，编写转换器后问题求助

你碰到的这个转换异常，本质是EclipseLink对Java 8的java.time.LocalDate类型默认支持不足导致的，下面给你两种实用的解决思路：

方法一：升级EclipseLink到2.6及以上版本（优先推荐） #

从EclipseLink 2.6版本开始，官方已经原生支持Java 8的java.time系列日期类型，不需要手动写转换器就能直接用。

如果你的项目用Maven管理依赖，直接在pom.xml里更新EclipseLink的版本即可：

<dependency>
    <groupId>org.eclipse.persistence</groupId>
    <artifactId>eclipselink</artifactId>
    <version>2.7.10</version> <!-- 也可以选更高的稳定版本 -->
</dependency>

更新后，只要给实体类的id字段补上必填的@Id注解，剩下的不用额外修改，数据库里对应issueDate的列用DATE类型就好：

@Entity
public class Employee {
    @Id
    private Long id;
    private LocalDate issueDate;
    // getters and setters
}

方法二：自定义AttributeConverter（适用于无法升级版本的场景） #

如果项目有依赖限制没法升级EclipseLink，那就手动写一个转换器来处理LocalDate和数据库类型的转换：

1. 编写转换器类 #

这里提供两种转换逻辑，选适合你数据库列类型的就行：

方案A：LocalDate ↔ 字符串（数据库列用VARCHAR）

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;

@Converter(autoApply = true) // autoApply=true会自动作用于所有LocalDate字段
public class LocalDateConverter implements AttributeConverter<LocalDate, String> {
    private static final DateTimeFormatter DATE_FORMAT = DateTimeFormatter.ISO_LOCAL_DATE;

    @Override
    public String convertToDatabaseColumn(LocalDate localDate) {
        return localDate != null ? localDate.format(DATE_FORMAT) : null;
    }

    @Override
    public LocalDate convertToEntityAttribute(String dbValue) {
        return dbValue != null ? LocalDate.parse(dbValue, DATE_FORMAT) : null;
    }
}

方案B：LocalDate ↔ SQL Date（数据库列用DATE）

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;
import java.time.LocalDate;
import java.sql.Date;

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

    @Override
    public Date convertToDatabaseColumn(LocalDate localDate) {
        return localDate != null ? Date.valueOf(localDate) : null;
    }

    @Override
    public LocalDate convertToEntityAttribute(Date dbValue) {
        return dbValue != null ? dbValue.toLocalDate() : null;
    }
}

2. 绑定转换器到实体字段 #

如果没设置autoApply=true，需要在实体的issueDate字段上手动指定转换器：

@Entity
public class Employee {
    @Id
    private Long id;
    @Convert(converter = LocalDateConverter.class)
    private LocalDate issueDate;
    // getters and setters
}

额外提醒 #

• 要保证数据库列的类型和转换器的转换逻辑匹配，别出现字符串转换器对应DATE列的情况；
• 如果用Spring Data JPA，注意Spring版本和EclipseLink版本的兼容性，避免依赖冲突。

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