Spring Data Repository扩展自定义接口遇自动查询生成错误求助

这个问题是因为Spring Data JPA会尝试解析仓储接口（包括继承的自定义接口）里的所有方法名来自动生成查询，哪怕你用了默认方法实现，它还是会触发这个解析逻辑，最终抛出异常。这里有两种靠谱的解决方式：

方式一：用Spring Data自定义实现类（官方推荐） #

这是最规范的做法，把自定义方法的实现抽离到单独类中，彻底避免Spring自动解析方法名：

1. 保持自定义接口只定义方法，不要写实现：

public interface TransitTicketRepo {
    List<Ticket> findPossibleTickets(String zoneId);
}

2. 仓储接口同时继承JpaRepository和自定义接口：

public interface PublicTransportPricingZoneRepository extends JpaRepository<PricingZone, Long>, TransitTicketRepo {
    // 这里放Spring Data自动生成的查询方法
}

3. 创建仓储接口的实现类，命名必须遵循「仓储接口名+Impl」的规则，实现自定义接口的方法：

public class PublicTransportPricingZoneRepositoryImpl implements TransitTicketRepo {

    // 按需注入EntityManager或其他依赖
    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public List<Ticket> findPossibleTickets(String zoneId) {
        // 这里写你的自定义业务逻辑，比如用EntityManager构建查询
        // 示例逻辑：
        CriteriaBuilder cb = entityManager.getCriteriaBuilder();
        CriteriaQuery<Ticket> query = cb.createQuery(Ticket.class);
        Root<Ticket> root = query.from(Ticket.class);
        query.where(cb.equal(root.get("zoneId"), zoneId));
        return entityManager.createQuery(query).getResultList();
    }
}

Spring Data会自动识别这个带Impl后缀的实现类，把方法实现绑定到仓储接口上，不会再尝试自动生成查询。

方式二：给默认方法添加@Query注解阻止自动生成 #

如果不想单独写实现类，可以在默认方法上添加@Query注解，用一个合法的JPQL语句（哪怕是空逻辑的）告诉Spring不要解析方法名：

public interface PublicTransportPricingZoneRepository extends JpaRepository<PricingZone, Long>, TransitTicketRepo {

    @Override
    @Query("SELECT t FROM Ticket t WHERE 1=1") // 随便写一个合法JPQL即可，实际逻辑用默认方法实现
    default List<Ticket> findPossibleTickets(String zoneId) {
        // 你的自定义实现逻辑
        // 比如从缓存取数据、调用其他服务等
    }
}

这个方法更简洁，但属于hack式写法，官方更推荐第一种方式。

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