Spring Boot 3.2.6集成Causeway+PostgreSQL：convertToEntityAttribute调用异常

问题背景 #

现有基于Spring Boot 3.2.6、Java 21的REST API项目，采用JPA实体+Spring Data，数据库为PostgreSQL 16.2。为管理"admin"实体集成Causeway框架，并添加了适配Keycloak的安全依赖。集成后JPA实现被自动替换为EclipseLink，调整实体后项目可正常启动，但触发控制器请求时，含UUID、OffsetDateTime属性的实体抛出异常：调用org.apache.causeway.persistence.jpa.integration.typeconverters.java.util.JavaUtilUuidConverter的convertToEntityAttribute方法出错，OffsetDateTime属性存在同类问题。

问题1：是否可以换回Hibernate实现？ #

可以，Causeway支持切换回Hibernate，具体操作步骤如下：

• 排除EclipseLink依赖：在pom.xml（Maven）或build.gradle（Gradle）中，对Causeway的JPA持久化依赖添加排除规则，移除EclipseLink相关模块。
  Maven示例：

  <dependency>
      <groupId>org.apache.causeway.persistence</groupId>
      <artifactId>causeway-persistence-jpa-eclipselink</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.eclipse.persistence</groupId>
              <artifactId>eclipselink</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 引入Hibernate依赖：添加Spring Boot的JPA Starter（默认包含Hibernate），确保版本与Spring Boot 3.2.6兼容（Spring Boot 3.2.x默认适配Hibernate 6.4.x）。
  Maven示例：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
  

• 配置JPA提供者：在application.properties或application.yml中指定使用Hibernate：

  spring.jpa.provider=org.hibernate.jpa.HibernatePersistenceProvider
  causeway.persistence.jpa.provider=hibernate
  

• 验证配置：启动项目后检查日志，确认Hibernate被正常加载，实体映射无异常。

问题2：若无法换回Hibernate，如何解决类型转换异常？ #

如果必须保留EclipseLink，可通过以下方式解决UUID和OffsetDateTime的类型转换问题：

针对UUID属性 #

• 方式一：使用EclipseLink原生UUID转换器
  在实体的UUID字段上添加EclipseLink的@Converter注解，指定原生转换器：

  import org.eclipse.persistence.annotations.Converter;
  import org.eclipse.persistence.converters.UUIDConverter;
  
  @Entity
  public class Admin {
      @Id
      @Converter(converterClass = UUIDConverter.class)
      @Column(columnDefinition = "UUID")
      private UUID id;
      // 其他字段...
  }
  

• 方式二：禁用Causeway自动UUID转换
  在配置文件中关闭Causeway自带的UUID转换器，依赖PostgreSQL原生UUID类型映射：

  causeway.persistence.jpa.type-converters.java.util.uuid.enabled=false
  

  同时确保实体字段注解正确：

  @Column(columnDefinition = "UUID")
  private UUID id;
  

针对OffsetDateTime属性 #

• 添加EclipseLink Java 8扩展依赖（若未引入）：
  Maven示例：

  <dependency>
      <groupId>org.eclipse.persistence</groupId>
      <artifactId>org.eclipse.persistence.jpa.jpql</artifactId>
      <version>4.0.2</version> <!-- 适配Causeway的版本 -->
  </dependency>
  

• 配置字段转换器与列定义：

  @Column(columnDefinition = "TIMESTAMP WITH TIME ZONE")
  @Converter(converterClass = org.eclipse.persistence.converters.OffsetDateTimeConverter.class)
  private OffsetDateTime createTime;
  

• 全局配置EclipseLink日期时间处理：

  spring.jpa.properties.eclipse.persistence.persistence-unit.default-timezone=UTC
  spring.jpa.properties.eclipse.persistence.convert.java.time=true
  

通用排查要点 #

• 移除实体中Hibernate特有的注解（如@Type），确保注解与EclipseLink兼容
• 使用适配Java 21的PostgreSQL驱动（推荐org.postgresql:postgresql:42.7.3及以上版本）
• 检查Causeway自动类型转换配置，禁用与EclipseLink冲突的规则

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