Spring Data JPA中如何通过实体对象实现按例查询？

你当前的自定义@Query启动失败，核心原因是JPQL语法错误：

1. SELECT子句写法错误，正确的实体别名定义应放在FROM子句，需改为SELECT s FROM Socks s
2. 参数引用方式错误，JPQL不支持直接用:socks.color引用实体属性，需通过Spring SpEL表达式获取属性值

以下是三种可行的实现方案：

方案一：修正自定义JPQL查询 #

适合明确知道查询字段的场景，手动编写JPQL条件，通过SpEL表达式引用实体属性：

@RepositoryDefinition(idClass = UUID.class, domainClass = Socks.class)
public interface SocksDao {

    @Query("""
            SELECT s
            FROM Socks s
            WHERE s.color = :#{#socks.color}
            AND s.cottonContent = :#{#socks.cottonContent}
            """)
    Socks findBy(@Param("socks") Socks socks);
}

方案二：使用Query By Example（QBE）推荐 #

Spring Data开箱即用的特性，无需编写JPQL，直接用实体对象作为查询模板，自动生成查询语句，完美适配字段多、避免参数臃肿的场景。

步骤1：修改Dao接口继承QueryByExampleExecutor #

@RepositoryDefinition(idClass = UUID.class, domainClass = Socks.class)
public interface SocksDao extends QueryByExampleExecutor<Socks> {
}

步骤2：业务代码中执行查询 #

// 构造查询模板：仅设置需要作为条件的字段，null字段不会参与查询
Socks queryTemplate = new Socks();
queryTemplate.setColor("white");
queryTemplate.setCottonContent(70);

// 创建Example对象，默认精确匹配非null字段
Example<Socks> example = Example.of(queryTemplate);

// 执行查询，返回Optional避免空指针
Optional<Socks> result = socksDao.findOne(example);

如需自定义匹配规则（如模糊查询），可搭配ExampleMatcher：

ExampleMatcher matcher = ExampleMatcher.matching()
        .withMatcher("color", match -> match.contains()); // color字段模糊匹配

Example<Socks> example = Example.of(queryTemplate, matcher);

方案三：使用Specification实现动态查询 #

适合需要灵活动态调整查询条件的场景（如根据参数是否为空决定是否加入条件）。

步骤1：修改Dao接口继承JpaSpecificationExecutor #

@RepositoryDefinition(idClass = UUID.class, domainClass = Socks.class)
public interface SocksDao extends JpaSpecificationExecutor<Socks> {
}

步骤2：编写Specification并执行查询 #

Socks queryTemplate = new Socks();
queryTemplate.setColor("black");
queryTemplate.setCottonContent(95);

// 构建动态查询条件
Specification<Socks> spec = (root, query, cb) -> {
    List<Predicate> predicates = new ArrayList<>();
    // 仅当字段非null时加入查询条件
    if (queryTemplate.getColor() != null) {
        predicates.add(cb.equal(root.get("color"), queryTemplate.getColor()));
    }
    if (queryTemplate.getCottonContent() != null) {
        predicates.add(cb.equal(root.get("cottonContent"), queryTemplate.getCottonContent()));
    }
    return cb.and(predicates.toArray(new Predicate[0]));
};

// 执行查询
Optional<Socks> result = socksDao.findOne(spec);

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