Spring Data Mongo：如何基于可选属性过滤MongoDB文档？

我来帮你搞定这个MongoDB查询的问题～你遇到的核心问题是Spring Data MongoDB默认不会把null参数当成「忽略该查询条件」来处理，不管是派生查询还是默认的Example查询，都会把null当作「匹配字段值为null」的条件，这就和你想要的「传null就忽略这个条件」的需求矛盾了。下面给你几个可行的解决方案：

方案1：给Example查询配置忽略null的Matcher #

你之前用的Example查询之所以失效，是因为默认的ExampleMatcher会把所有非null属性作为匹配条件，甚至会把null属性当成「匹配数据库中该字段为null」的条件。只需要给Example加上一个忽略null值的Matcher就能解决：

// 构建匹配规则：忽略所有null属性，只使用非null的属性作为查询条件
ExampleMatcher matcher = ExampleMatcher.matching()
    .withIgnoreNullValues(); // 关键：忽略null属性，不参与查询匹配

// 构建查询示例对象
Company companyExample = Company.builder()
    .companyName(null) // 这个null会被Matcher忽略
    .departmentName("Marketing") // 只有这个非null属性会作为查询条件
    .build();

// 执行查询
repository.findAll(Example.of(companyExample, matcher))
    .subscribe(System.out::println);

这样执行后，就只会匹配departmentName为Marketing的文档，符合你的预期。

方案2：用@Query自定义动态查询语句 #

如果觉得Example的方式不够灵活，也可以直接用@Query注解写MongoDB原生的动态查询逻辑，判断参数是否为null，不为null才加入查询条件：

public interface CompanyRepository extends ReactiveMongoRepository<Company, String> {

    @Query("{$and: [" +
        "?0 != null ? {companyName: ?0} : {}, " +
        "?1 != null ? {departmentName: ?1} : {}" +
        "]}")
    Flux<Company> findMatchingCompanies(String companyName, String departmentName);
}

这里的MongoDB查询逻辑很简单：如果第一个参数（companyName）不为null，就加入companyName: ?0的条件，否则加入空文档{}（不影响查询）；第二个参数同理。这样不管你传哪个参数为null，都会自动忽略对应的条件。

方案3：用Querydsl实现更灵活的动态查询 #

如果你的项目已经引入了Querydsl依赖，这种方式会更适合复杂的动态查询场景：

首先，让你的Repository继承ReactiveQuerydslPredicateExecutor：

public interface CompanyRepository extends ReactiveMongoRepository<Company, String>, ReactiveQuerydslPredicateExecutor<Company> {
}

然后就可以动态构建查询条件了：

// 假设你的实体对应的Querydsl类是QCompany（自动生成）
QCompany qCompany = QCompany.company;
BooleanBuilder predicateBuilder = new BooleanBuilder();

// 只在参数不为null时添加对应的查询条件
if (companyName != null) {
    predicateBuilder.and(qCompany.companyName.eq(companyName));
}
if (departmentName != null) {
    predicateBuilder.and(qCompany.departmentName.eq(departmentName));
}

// 执行查询
repository.findAll(predicateBuilder)
    .subscribe(System.out::println);

这种方式的好处是可以灵活添加各种复杂条件，比如模糊匹配、范围查询等，扩展性更强。

为什么之前的方法失效？ #

• 方法1的派生查询：Spring Data的派生查询会把null参数解析为「匹配字段值为null」的条件，而不是忽略该条件。所以当你传companyName=null时，它会去查companyName为null的文档，自然没有结果。
• 方法2的默认Example查询：默认的ExampleMatcher不会忽略null属性，而是会匹配数据库中该字段为null的文档，所以你传companyName=null时，它会找companyName为null的文档，和你的数据不匹配，返回0条。

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