使用查询参数过滤Spring Data REST结果时自定义方法不生效如何解决

根本原因：Spring Data REST 默认不会将根集合资源 /tasks 的 GET 请求参数和自定义查询方法绑定，所有自定义查询方法默认需暴露到 /tasks/search 子路径下才能被路由到，你当前的写法没有显式暴露自定义查询方法，因此请求只会默认路由到findAll方法返回全量数据。

方案一：使用框架原生搜索端点（推荐，符合设计规范） #

给自定义查询方法添加@RestResource注解显式暴露为搜索资源：

@RepositoryRestResource(collectionResourceRel = "tasks", path = "tasks")
public interface TaskRepository extends JpaRepository<Task, Long> {

    @RestResource(path = "byOrganizationId", rel = "byOrganizationId")
    List<Task> findByOrganizationId(@Param("organizationId") Long organizationId);
}

配置完成后通过以下路径访问即可命中你的自定义查询方法：
GET /tasks/search/byOrganizationId?organizationId=2
你也可以访问GET /tasks/search查看所有已暴露的搜索方法列表。

方案二：直接在根路径实现参数过滤 #

如果不想用/search子路径，需要直接通过/tasks?organizationId=2实现过滤，可以通过集成QueryDSL实现自动参数绑定：

1. 项目引入QueryDSL相关依赖
2. 调整Repository继承QuerydslPredicateExecutor接口：

@RepositoryRestResource(collectionResourceRel = "tasks", path = "tasks")
public interface TaskRepository extends JpaRepository<Task, Long>, QuerydslPredicateExecutor<Task> {
    // 不需要手动写查询方法
}

配置完成后Spring Data REST会自动将请求参数和实体属性绑定生成查询条件，直接访问GET /tasks?organizationId=2就会返回匹配的Task数据，所有实体属性都支持直接作为查询参数使用，无需额外编码。

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