Spring JPA Example查询异常：传入空Example对象报错

当你通过全空的MyEntity实例创建Example对象时，Spring Data JPA会生成无效的SQL条件?=1，并将BIT类型的true作为参数绑定，导致Hibernate抛出Fail to convert to internal representation错误。这是因为框架无法从空实体中提取可用于查询的属性，生成了错误的默认条件。

解决办法 #

1. 提前判断实体是否为空，跳过Example查询

在构建Example前，先检查实体的所有属性是否为空，若是则直接调用无参查询：

MyEntity entity = new MyEntity();
// 自定义方法判断实体所有属性是否为空（可通过反射或BeanUtils实现）
boolean isEmpty = checkAllFieldsNull(entity);

if (isEmpty) {
    return myEntityRepository.findAll();
} else {
    Example<MyEntity> example = Example.of(entity, ExampleMatcher.matching());
    return myEntityRepository.findAll(example);
}

2. 配置ExampleMatcher忽略空值属性

通过withIgnoreNullValues()让框架忽略所有空属性，避免生成无效条件：

ExampleMatcher matcher = ExampleMatcher.matching()
    .withIgnoreNullValues(); // 忽略所有空值属性
    // 可选：添加.withIgnorePaths("id")忽略主键等不需要匹配的字段

Example<MyEntity> example = Example.of(new MyEntity(), matcher);
List<MyEntity> result = myEntityRepository.findAll(example);

配置后，空实体对应的查询不会生成WHERE子句，直接返回全量数据。

3. 改用Specification实现动态查询

如果Example匹配无法满足需求，用Specification手动构建条件，只处理非空属性：

MyEntity entity = new MyEntity();
Specification<MyEntity> spec = (root, query, cb) -> {
    List<Predicate> predicates = new ArrayList<>();
    
    if (entity.getName() != null) {
        predicates.add(cb.equal(root.get("name"), entity.getName()));
    }
    // 依次判断其他需要匹配的属性...
    
    return cb.and(predicates.toArray(new Predicate[0]));
};

List<MyEntity> result = myEntityRepository.findAll(spec);

错误原因说明 #

当实体无任何非空属性时，Spring Data JPA无法生成有效的查询条件，内部会尝试生成一个类似1=1的恒真条件，但错误地将实体的类型标识（BIT类型的true）绑定到参数中，导致数据库无法完成类型转换，最终抛出转换错误。

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