Spring Data Jpa 3.0.0中YesNoConverter与JpaRepository查询异常问题

问题原因 #

Spring Data JPA 3.0 对派生查询的布尔谓词（如findByActiveFalse()这类后缀为False/True的方法）处理逻辑变更：默认直接生成数据库原生布尔值（0/1）作为查询条件，不会触发Hibernate的YesNoConverter进行Y/N的转换，导致SQL执行报错；而findByActive(false)这类传参查询会正常经过转换器处理，因此可以正常工作。

解决方案 #

方案1：使用@Query手动编写JPQL/SQL #

直接在Repository方法上通过@Query指定查询语句，使用转换器对应的字符串值（'N'/'Y'）作为条件：

@Repository
public interface ExampleEntityRepo extends JpaRepository<ExampleEntity, Long> {

    @Query("SELECT e FROM ExampleEntity e WHERE e.active = 'N'")
    List<ExampleEntity> findByActiveFalse();

    // 对应findByActiveTrue()的写法
    @Query("SELECT e FROM ExampleEntity e WHERE e.active = 'Y'")
    List<ExampleEntity> findByActiveTrue();
}

这种方式最直接，完全绕过Spring Data JPA的自动谓词生成，确保查询条件使用正确的Y/N值。

方案2：自定义Repository基类扩展谓词处理逻辑 #

如果有大量类似的布尔字段查询需要处理，可以自定义Repository基类，重写布尔谓词的生成逻辑，让其自动应用AttributeConverter：

1. 创建自定义Repository实现类：

public class CustomJpaRepositoryImpl<T, ID> extends SimpleJpaRepository<T, ID> {

    private final EntityManager entityManager;

    public CustomJpaRepositoryImpl(JpaEntityInformation<T, ?> entityInformation, EntityManager entityManager) {
        super(entityInformation, entityManager);
        this.entityManager = entityManager;
    }

    // 示例：自定义方法处理active=false的查询
    public List<T> findByActiveFalse() {
        CriteriaBuilder cb = entityManager.getCriteriaBuilder();
        CriteriaQuery<T> query = cb.createQuery(getDomainClass());
        Root<T> root = query.from(getDomainClass());
        
        // 获取字段的Converter，转换false为'N'
        AttributeConverter<Boolean, String> converter = new YesNoConverter();
        query.where(cb.equal(root.get("active"), converter.convertToDatabaseColumn(false)));
        
        return entityManager.createQuery(query).getResultList();
    }
}

2. 配置Spring Data JPA使用自定义基类：
   在Spring Boot启动类上添加@EnableJpaRepositories指定基类：

@SpringBootApplication
@EnableJpaRepositories(repositoryBaseClass = CustomJpaRepositoryImpl.class)
public class BooleanConverterDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(BooleanConverterDemoApplication.class, args);
    }
}

这种方式适合批量处理多个类似查询，避免重复编写@Query。

方案3：确保Converter的全局生效配置 #

如果使用自定义Converter，需设置autoApply = true确保实体字段的读写自动转换（注意：此配置仅解决实体字段的读写转换，派生查询仍需配合方案1或2）：

@Converter(autoApply = true)
public class BooleanToYesNoConverter implements AttributeConverter<Boolean, String> {
    @Override
    public String convertToDatabaseColumn(Boolean attribute) {
        return attribute != null && attribute ? "Y" : "N";
    }

    @Override
    public Boolean convertToEntityAttribute(String dbData) {
        return "Y".equals(dbData);
    }
}

验证 #

修改后运行测试用例，findByActiveFalse()生成的SQL会使用e1_0.active='N'作为条件，即可正常执行查询。

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