如何编写Spring Data JPA方法实现Symbol匹配或Name模糊匹配查询

private String symbol;
private String name;
...
}

需求：实现一个Spring Data JPA方法，接收String参数，**优先精确匹配`symbol`属性**；若无匹配项，则**模糊匹配`name`属性**，返回对应结果。

用户尝试的实现及问题：
编写默认方法时调用`findOne(Specification)`出现类型绑定错误：
> Inferred type 'S' for type parameter 'S' is not within its bound; should extend 'com.abc.domain.Foo'

替换为自定义`findById(Specification<Foo> spec)`后，调用时出现IDE错误：
> Cannot resolve symbol 'FooRepository' in a class importing the repository and
> Cannot resolve method 'existsById(Long)'

仓库基础定义：
```java
@SuppressWarnings("unused")
@Repository
public interface FooRepository extends JpaRepository<Foo, Long> { ...}

核心问题 #

1. 仓库未继承JpaSpecificationExecutor<Foo>接口，导致无法使用基于Specification的查询方法。
2. 自定义方法签名错误：返回类型写成了Stock（应为Foo），且findById是主键查询方法，不能传入Specification。

方案一：命名查询实现（简单直观） #

直接定义两个基础查询方法，通过默认方法实现优先级逻辑：

@SuppressWarnings("unused")
@Repository
public interface FooRepository extends JpaRepository<Foo, Long> {
    // 精确匹配symbol
    Optional<Foo> findBySymbol(String symbol);
    
    // 模糊匹配name（Spring Data自动解析Containing为%xxx%）
    List<Foo> findByNameContaining(String name);
    
    // 实现优先匹配逻辑
    default Optional<Foo> findBySymbolOrName(String term) {
        // 先查symbol精确匹配
        Optional<Foo> symbolMatch = findBySymbol(term);
        if (symbolMatch.isPresent()) {
            return symbolMatch;
        }
        // 无匹配时取name模糊匹配的第一个结果
        return findByNameContaining(term).stream().findFirst();
    }
}

方案二：Specification实现（灵活扩展） #

如果需要复杂查询逻辑，让仓库继承JpaSpecificationExecutor<Foo>，用Specification构建查询：

@SuppressWarnings("unused")
@Repository
public interface FooRepository extends JpaRepository<Foo, Long>, JpaSpecificationExecutor<Foo> {
    default Optional<Foo> findBySymbolOrName(String term) {
        // 构建symbol精确匹配的Specification
        Specification<Foo> symbolSpec = (root, query, cb) -> cb.equal(root.get("symbol"), term);
        Optional<Foo> symbolMatch = findOne(symbolSpec);
        
        if (symbolMatch.isPresent()) {
            return symbolMatch;
        }
        
        // 构建name模糊匹配的Specification（统一转小写避免大小写敏感）
        Specification<Foo> nameSpec = (root, query, cb) -> 
            cb.like(cb.lower(root.get("name")), "%" + term.toLowerCase() + "%");
        
        // 可选：添加排序保证结果稳定
        query.orderBy(cb.asc(root.get("name")));
        
        return findOne(nameSpec);
    }
}

注意事项 #

• 模糊匹配时建议统一大小写，避免数据库大小写规则导致漏查。
• 若name模糊匹配返回多个结果，可根据业务需求排序后取第一个，或直接返回列表。
• 确保仓库正确继承所需扩展接口（JpaSpecificationExecutor用于Specification查询）。

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