Spring Boot自定义Repository实现未识别、自定义方法不执行问题

自定义Spring Data JPA Repository实现类可正常实例化（启动时打印I got constructed日志），但调用自定义方法findAllContainingName时，方法内部的I got called with: 日志始终不输出，自定义逻辑未被执行。 #

Repository层定义 #

public interface ServiceRepository<T extends ServiceEntity> extends JpaRepository<T, UUID>, ServiceRepositoryCustom {
}

public interface ServiceRepositoryCustom {
    List<ServiceEntity> findAllContainingName(String query);
}

@Repository("Repo")
public class ServiceRepositoryCustomImpl implements ServiceRepositoryCustom {


    private final EntityManager em;

    public ServiceRepositoryCustomImpl(EntityManager em) {
        System.out.println("I got constructed");
        this.em = em;
    }

    @Override
    public List<ServiceEntity> findAllContainingName(String name) {
        System.out.println("I got called with: " + name);
        CriteriaBuilder cb = em.getCriteriaBuilder();
        CriteriaQuery<ServiceEntity> cq = cb.createQuery(ServiceEntity.class);

        Root<ServiceEntity> serviceEntity = cq.from(ServiceEntity.class);
        List<Predicate> predicates = new ArrayList<>();

        if(name != null)  {
            // predicates.add(cb.equal(serviceEntity.get("name"), name));
            predicates.add(cb.like(serviceEntity.get("name"), name + "%"));
        }
        cq.where(predicates.toArray(predicates.toArray(new Predicate[0])));

        return em.createQuery(cq).getResultList();
    }
}

子Repository与注册逻辑 #

@Repository
public interface PineappleServiceRepository extends ServiceRepository<PineappleServiceEntity> {
}

@Component("Registry")
@DependsOn({"Context", "Repo"})
public class Registry {
    private final List<ServiceRepository<? extends ServiceEntity>> serviceRepositories = new ArrayList<>();

    public Registry(PineappleServiceRepository pineappleServiceRepository) {
        this.serviceRepositories.add(pineappleServiceRepository);
    }
}

接口调用逻辑 #

@RestController
@RequestMapping("/test")
@DependsOn("Registry")
public class ServiceController {

    private final Registry registry;

    public ServiceController(@NotNull Registry registry) {
        this.registry = registry;
    }

    @GetMapping("")
    List<ServiceEntity> all(@RequestParam("q") String query) {
        return getAllServices(query);
    }

    private @NotNull List<ServiceEntity> getAllServices(String query) {
        List<ServiceEntity> response = new ArrayList<>();
        for(ServiceRepository<? extends ServiceEntity> repo: this.registry.getServiceRepositories()){
             response.addAll(repo.findAllContainingName(query));
        }
        return response;
    }
}

实体类定义 #

@Entity
@Table(name = "services")
public abstract class ServiceEntity {

    protected @Id
    UUID id = UUID.randomUUID();
    protected String name;

    // 构造方法、Getter、Setter省略
}

@Entity
public class PineappleServiceEntity extends ServiceEntity {
    // 独有属性、对应构造方法、Getter、Setter省略
}

问题核心是Spring Data JPA的自定义Repository实现绑定规则和现有配置存在冲突，具体问题点和修复方式如下：

• 自定义实现类被错误注册为独立Bean
  给ServiceRepositoryCustomImpl加了@Repository("Repo")注解后，Spring会直接把这个类实例化为一个独立的IoC容器Bean，这就是能看到构造日志的原因。但这个Bean和Spring Data为PineappleServiceRepository生成的动态代理对象完全无关，代理内部根本没有注入这个实例，调用方法自然不会走自定义逻辑。

  修复：直接移除ServiceRepositoryCustomImpl上的@Repository("Repo")注解，不要让Spring单独实例化这个类，自定义Repository实现应该交给Spring Data的Repository工厂负责实例化和织入。

• 自定义实现类不符合默认绑定规则
  Spring Data JPA默认的自定义实现查找规则是：为每个具体的Repository接口，查找同包下类名为[Repository接口名]Impl的类作为自定义方法实现。比如PineappleServiceRepository，默认只会查找PineappleServiceRepositoryImpl作为自定义实现，写的ServiceRepositoryCustomImpl是顶层自定义接口的实现，不会被自动织入到子Repository的代理中。

  两种修复方案选其一即可：

  1. 快速验证方案：在PineappleServiceRepository同包下新建PineappleServiceRepositoryImpl类，继承ServiceRepositoryCustomImpl，提供匹配的构造方法，Spring Data会自动识别这个类并织入代理，调用方法即可触发日志打印。
  2. 通用基类方案（适合多个子Repository复用逻辑的场景）：将ServiceRepositoryCustomImpl改造为继承SimpleJpaRepository的通用Repository基类，实现ServiceRepositoryCustom接口，然后在配置类/启动类的@EnableJpaRepositories注解上指定repositoryBaseClass = ServiceRepositoryCustomImpl.class，这样所有继承ServiceRepository的子接口生成代理时，都会自动使用这个基类的自定义逻辑。

• 查询逻辑存在泛型不匹配问题
  当前自定义实现里的Criteria查询写死了Root<ServiceEntity>，直接查询抽象父类，就算逻辑触发，返回的结果会是所有继承ServiceEntity的子类实体混合数据，后续类型转换容易报错。

  修复：采用通用基类方案时，可以在构造方法里拿到当前Repository对应的具体实体类类型，动态生成对应实体的Criteria查询Root，避免写死父类类型。

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