Angular+Spring Boot项目中JPA @Query多过滤条件查询异常排查

嘿，这个问题我之前帮朋友排查过类似的，大概率是你的JPA查询语句没处理好空值/空字符串的判断逻辑，咱们一步步拆解问题根源和解决办法：

可能的问题根源 #

1. JPQL查询条件硬绑定了非空判断 #

如果你的@Query写的是类似下面这种硬拼接的条件：

@Query("SELECT u FROM User u WHERE u.name = :name AND u.age = :age")
List<User> findByFilters(@Param("name") String name, @Param("age") String age);

当你只填一个过滤字段（比如name="张三"），另一个字段传了空字符串或null时，生成的SQL会变成WHERE name='张三' AND age=''（或age IS NULL）。如果数据库里没有age为空的记录，自然会返回0条结果——这就是问题所在：空字段的条件反而变成了“必须匹配空值”，而不是“忽略该条件”。

2. 前端传参格式问题 #

Angular组件里如果空字段默认传的是空字符串（而非null），Spring Boot接收时拿到的就是空字符串，而非null。这时候即使JPQL里判断了IS NULL，也无法匹配空字符串，导致条件失效。

解决方案 #

方案一：修改JPQL，动态忽略空值/空字符串 #

直接在JPQL里给每个条件加上“参数为空则忽略”的逻辑，比如：

@Query("SELECT u FROM User u WHERE " +
       "(:name IS NULL OR :name = '' OR u.name = :name) AND " +
       "(:age IS NULL OR :age = '' OR u.age = :age)")
List<User> findByFilters(@Param("name") String name, @Param("age") String age);

这样当某个参数是null或空字符串时，该条件会自动跳过，只生效有实际值的过滤条件。

方案二：用Spring Data JPA动态查询（更适合多条件场景） #

如果过滤字段比较多，手写JPQL容易出错，可以用Specifications或Querydsl实现动态拼接条件。比如用Specifications：

1. 让你的Repository继承JpaSpecificationExecutor<User>
2. 编写动态查询逻辑：

public class UserSpecifications {
    public static Specification<User> withFilters(String name, String age) {
        return (root, query, cb) -> {
            List<Predicate> predicates = new ArrayList<>();
            // 仅当参数非空且非空字符串时，添加条件
            if (name != null && !name.isEmpty()) {
                predicates.add(cb.equal(root.get("name"), name));
            }
            if (age != null && !age.isEmpty()) {
                predicates.add(cb.equal(root.get("age"), age));
            }
            return cb.and(predicates.toArray(new Predicate[0]));
        };
    }
}

调用时直接传这个Specification即可，只会拼接有值的条件。

方案三：调整前端传参逻辑 #

让Angular在发送请求时，过滤掉空值字段或者将空字符串转为null：

// 构造过滤参数时，移除空值字段
const filterParams = {
  name: this.nameFilter,
  age: this.ageFilter
};
// 删除空值的键
Object.keys(filterParams).forEach(key => {
  if (!filterParams[key]) delete filterParams[key];
});
// 发送POST请求
this.http.post('/api/users/filter', filterParams).subscribe(...);

这样Spring Boot接收时，未填写的字段不会出现在请求体里，对应参数会是null，JPQL里只需要判断(:name IS NULL OR u.name = :name)即可。

调试小技巧 #

可以在Spring Boot的配置文件里开启SQL打印，查看实际执行的SQL语句，方便定位问题：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

这样就能清晰看到每个参数对应生成的条件，快速排查哪里出了问题。

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