如何自动为JpaRepository所有方法添加finished=false过滤条件？

你完全可以通过配置让TaskRepository的所有默认方法自动只处理finished=false的记录，不用逐个方法改命名，下面是几种实用方案：

1. 实体类加@Where注解（最快实现） #

直接在Task实体上贴Hibernate的@Where注解，全局生效：

import org.hibernate.annotations.Where;
import jakarta.persistence.Entity;

@Entity
@Where(clause = "finished = false")
public class Task {
    private boolean finished;
    // 其他字段、getter/setter
}

这样不管是调用findAll()、findById()还是其他默认查询方法，都会自动带上finished=false的过滤条件。连删除、更新操作也会遵循这个规则——比如deleteById()只会删掉未完成的任务。

注意：这是Hibernate专属注解，不是JPA标准，如果你的项目换了JPA实现，这个配置会失效。

2. 自定义仓库实现（灵活可控） #

如果需要某些方法绕过过滤，或者不想依赖Hibernate特性，可以用Spring Data的自定义仓库：

第一步，让TaskRepository继承JpaSpecificationExecutor：

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.JpaSpecificationExecutor;

public interface TaskRepository extends JpaRepository<Task, Long>, JpaSpecificationExecutor<Task> {
}

第二步，写一个自定义的实现类，重写默认方法并注入过滤规则：

import org.springframework.data.jpa.domain.Specification;
import org.springframework.data.jpa.repository.support.SimpleJpaRepository;
import jakarta.persistence.EntityManager;
import java.util.List;
import java.util.Optional;

public class CustomTaskRepositoryImpl extends SimpleJpaRepository<Task, Long> {
    // 定义全局过滤规则
    private static final Specification<Task> ONLY_UNFINISHED = 
        (root, query, cb) -> cb.equal(root.get("finished"), false);

    public CustomTaskRepositoryImpl(EntityManager em) {
        super(Task.class, em);
    }

    @Override
    public List<Task> findAll() {
        return findAll(ONLY_UNFINISHED);
    }

    @Override
    public Optional<Task> findById(Long id) {
        // 把ID查询和全局过滤结合
        return findOne(ONLY_UNFINISHED.and((root, query, cb) -> cb.equal(root.get("id"), id)));
    }

    // 按需重写其他方法，比如count()、findAllById()等
}

第三步，在TaskRepository上指定用这个自定义实现：

import org.springframework.data.jpa.repository.RepositoryBaseClass;
import org.springframework.stereotype.Repository;

@Repository
@RepositoryBaseClass(CustomTaskRepositoryImpl.class)
public interface TaskRepository extends JpaRepository<Task, Long>, JpaSpecificationExecutor<Task> {
}

这种方式可以精准控制哪些方法应用过滤，完全基于Spring Data标准，兼容性更好。

3. @Query注解（针对单个方法） #

如果只是少数方法需要过滤，也可以直接用@Query手动写SQL/JPQL，比如：

public interface TaskRepository extends JpaRepository<Task, Long> {
    @Query("SELECT t FROM Task t WHERE t.finished = false")
    List<Task> findAllUnfinished();

    @Modifying
    @Query("UPDATE Task t SET t.description = ?1 WHERE t.id = ?2 AND t.finished = false")
    int updateUnfinishedTaskDesc(String desc, Long id);
}

但这种方式需要逐个方法定义，适合不需要全局过滤的场景。

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