Spring Data JPA执行@Query前转换参数类型是否可行？

使用Spring Data JPA 3.0.4搭配Hibernate 6.1.7.Final，编写了如下查询方法：

@Query("SELECT CASE WHEN COUNT(t) > 0 THEN TRUE ELSE FALSE END FROM Teacher t " +
        "JOIN t.user u " +
        "WHERE u.role.id = :idRole")
boolean test(RoleId idRole);

其中RoleId是封装Long类型ID的自定义包装类，而Role实体的id字段为Long类型，执行时抛出错误：

org.hibernate.type.descriptor.java.CoercionException: Cannot coerce value `.wrapper.RoleId@3d` [.wrapper.RoleId] as Long

需求：在执行带有RoleId参数的@Query方法前，自动将其解包为Long类型值传入查询。

方法1：全局自动转换（推荐） #

实现JPA的AttributeConverter并设置自动生效，让框架自动处理RoleId与Long的转换：

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;

@Converter(autoApply = true)
public class RoleIdConverter implements AttributeConverter<RoleId, Long> {

    @Override
    public Long convertToDatabaseColumn(RoleId roleId) {
        return roleId != null ? roleId.getValue() : null; // 假设RoleId有getValue()方法获取内部Long值
    }

    @Override
    public RoleId convertToEntityAttribute(Long dbValue) {
        return dbValue != null ? new RoleId(dbValue) : null;
    }
}

添加@Converter(autoApply = true)后，所有涉及RoleId的JPA操作都会自动完成类型转换，包括@Query方法的参数。

方法2：自定义参数解析器（灵活控制） #

如果需要针对特定场景转换，而非全局生效，可以实现Spring Data的QueryMethodParameterConverter：

import org.springframework.data.jpa.repository.query.QueryMethodParameterConversionException;
import org.springframework.data.jpa.repository.query.QueryMethodParameterConverter;
import org.springframework.lang.NonNull;
import org.springframework.stereotype.Component;

@Component
public class RoleIdParameterConverter implements QueryMethodParameterConverter {

    @Override
    public Object convert(@NonNull Object source, @NonNull Class<?> targetType) throws QueryMethodParameterConversionException {
        if (source instanceof RoleId && targetType.equals(Long.class)) {
            return ((RoleId) source).getValue();
        }
        return source;
    }
}

这个转换器会在Spring Data处理查询参数时触发，仅当参数是RoleId且目标类型为Long时进行转换。

方法3：手动解包（简单场景） #

如果不需要自动转换的全局能力，也可以修改Repository方法参数为Long，调用时手动传入解包后的值：

@Query("SELECT CASE WHEN COUNT(t) > 0 THEN TRUE ELSE FALSE END FROM Teacher t " +
        "JOIN t.user u " +
        "WHERE u.role.id = :idRole")
boolean test(@Param("idRole") Long idRole);

调用示例：teacherRepository.test(roleId.getValue());，但这种方式需要调用方手动处理，不符合"自动"需求，仅适合简单场景。

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