Spring Boot 3.3：如何向JPA AttributeConverter注入配置属性？

问题背景 #

将Spring Boot版本从3.1升级到3.3后，带有@Converter(autoApply = true)注解的MyConverter不再调用包含@Value注入的带参构造器，转而使用无参构造器，导致配置属性无法正常获取。ChatGPT提到该变化源于Spring Boot 3.2+开始严格遵循JPA规范，但官方发布说明中未直接提及。

官方文档与变更依据 #

该变更的本质是Spring Boot 3.2调整了与Hibernate的集成逻辑：此前版本会通过Spring容器实例化JPA AttributeConverter，从而支持依赖注入；3.2及之后版本则严格遵循JPA规范，将转换器的实例化权交还给Hibernate（JPA提供者），而JPA规范明确要求AttributeConverter必须提供无参构造器，且不强制支持依赖注入。

相关调整可通过Spring Boot 3.2的自动配置类变更确认，比如HibernateJpaAutoConfiguration中移除了对转换器的Spring容器托管逻辑，同时Hibernate的官方文档也明确说明：转换器由Hibernate实例化，仅支持通过Configurable接口获取配置参数，不支持外部依赖注入。

可行解决方案 #

方案1：利用Hibernate的Configurable接口获取配置 #

直接通过Hibernate提供的Configurable接口在转换器初始化时读取配置参数，无需依赖Spring注入，完全符合JPA规范：

@Converter(autoApply = true)
public class MyConverter implements AttributeConverter<OffsetDateTime, Timestamp>, Configurable {

    private TimeZone dbTimeZone;

    @Override
    public void configure(Map<String, Object> configuration) {
        String timeZoneName = (String) configuration.get("hibernate.jdbc.time_zone");
        this.dbTimeZone = TimeZone.getTimeZone(timeZoneName);
    }

    @Override
    public Timestamp convertToDatabaseColumn(OffsetDateTime attribute) {
        if (attribute == null) {
            return null;
        }
        return Timestamp.from(attribute.atZoneSameInstant(dbTimeZone.toZoneId()).toInstant());
    }

    @Override
    public OffsetDateTime convertToEntityAttribute(Timestamp dbData) {
        if (dbData == null) {
            return null;
        }
        return dbData.toInstant().atZone(dbTimeZone.toZoneId()).toOffsetDateTime();
    }
}

方案2：通过@Configurable实现Spring依赖注入 #

借助Spring的@Configurable注解和AspectJ编译时增强，让Spring管理由Hibernate实例化的转换器实例，从而支持@Value注入：

1. 启用AspectJ编译时增强（Maven示例）：
   在pom.xml中添加AspectJ插件和依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-aop</artifactId>
    </dependency>
    <dependency>
        <groupId>org.aspectj</groupId>
        <artifactId>aspectjweaver</artifactId>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>aspectj-maven-plugin</artifactId>
            <version>1.14.0</version>
            <executions>
                <execution>
                    <goals>
                        <goal>compile</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <complianceLevel>17</complianceLevel> <!-- 对应你的JDK版本 -->
                <aspectLibraries>
                    <aspectLibrary>
                        <groupId>org.springframework</groupId>
                        <artifactId>spring-aspects</artifactId>
                    </aspectLibrary>
                </aspectLibraries>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 修改转换器类，添加@Configurable注解：

@Converter(autoApply = true)
@Configurable
public class MyConverter implements AttributeConverter<OffsetDateTime, Timestamp> {

    @Value("${spring.jpa.properties.hibernate.jdbc.time_zone}")
    private String dbTimeZoneName;

    private TimeZone dbTimeZone;

    public MyConverter() {
        // 无参构造器，满足JPA规范
    }

    @PostConstruct
    public void init() {
        this.dbTimeZone = TimeZone.getTimeZone(dbTimeZoneName);
    }

    // 实现转换方法...
}

方案3：手动注册转换器为Spring Bean并禁用自动应用 #

移除autoApply = true，将转换器注册为Spring Bean，手动指定其使用场景，确保Spring管理实例并完成依赖注入：

1. 修改转换器类：

@Component
public class MyConverter implements AttributeConverter<OffsetDateTime, Timestamp> {

    private final TimeZone dbTimeZone;

    public MyConverter(@Value("${spring.jpa.properties.hibernate.jdbc.time_zone}") String dbTimeZoneName) {
        this.dbTimeZone = TimeZone.getTimeZone(dbTimeZoneName);
    }

    // 实现转换方法...
}

2. 在实体类字段上手动指定转换器：

@Entity
public class MyEntity {
    @Convert(converter = MyConverter.class)
    private OffsetDateTime dateTime;
    // 其他字段与方法...
}

或者通过配置文件全局指定转换器（需禁用自动应用）：

spring.jpa.properties.hibernate.converter.autoapply=false
spring.jpa.properties.hibernate.converter.classes=com.example.MyConverter

关于无参构造器的注意事项 #

移除无参构造器仅在Spring完全管理转换器实例时可行（如方案3），若保留autoApply = true且由Hibernate实例化转换器，缺少无参构造器会触发JPA规范异常，因此保留无参构造器是兼容混合场景的安全做法。

内容的提问来源于stack exchange，提问作者Marcel Stör