JPA MongoRepository带可选参数的自定义查询问题排查

你遇到的问题核心是自定义@Query没有实现“参数为空则忽略该条件”的逻辑，常见错误写法有两种：

1. 直接拼接所有固定条件，比如：

   @Query("{'state': ?0, 'type': ?1, 'priority': ?2}")
   List<Ticket> findByParams(EnumState state, EnumType type, EnumPriority priority);
   

   当参数为null时，MongoDB会查询对应字段等于null的文档，但你的枚举字段不会存null；如果代码里参数未传时默认值不是null（比如给了默认枚举值），或者错误用了$or逻辑（比如{$or: [{'state': ?0}, {'type': ?1}, {'priority': ?2}, {}]}），就会触发{}匹配所有文档的情况，导致无论传什么参数都返回全部数据。
2. 没有利用MongoDB的动态条件语法，直接写死查询结构，无法根据参数是否为空动态增减查询条件。

方式1：使用MongoDB的$expr和$cond实现动态条件 #

在@Query中通过MongoDB表达式判断参数是否为空，为空则跳过该条件：

@Query("""
    {
        $and: [
            { $cond: [ { $eq: [?0, null] }, {}, { 'state': ?0 } ] },
            { $cond: [ { $eq: [?1, null] }, {}, { 'type': ?1 } ] },
            { $cond: [ { $eq: [?2, null] }, {}, { 'priority': ?2 } ] }
        ]
    }
""")
List<Ticket> findByParams(EnumState state, EnumType type, EnumPriority priority);

原理：$cond会判断参数是否为null，如果是则返回{}（匹配所有），否则返回对应字段的匹配条件；$and保证所有非空参数的条件都同时满足。

方式2：使用Spring Data的查询推导（更简洁） #

不需要写自定义@Query，直接利用Spring Data的方法命名规则自动生成查询：

// 直接用参数，null会被自动忽略
List<Ticket> findByStateAndTypeAndPriority(EnumState state, EnumType type, EnumPriority priority);

// 或者用Optional明确标记可选参数
List<Ticket> findByStateOptionalAndTypeOptionalAndPriorityOptional(
    Optional<EnumState> state, 
    Optional<EnumType> type, 
    Optional<EnumPriority> priority
);

当参数为null或Optional.empty()时，Spring Data会自动忽略该条件，完全符合你的需求。

方式3：自定义Query方法（灵活度最高） #

如果需要更复杂的逻辑，可以手动构建Query：

@Repository
public interface TicketRepository extends MongoRepository<Ticket, String>, MongoTemplateAware {

    default List<Ticket> findByParams(EnumState state, EnumType type, EnumPriority priority) {
        Query query = new Query();
        if (state != null) {
            query.addCriteria(Criteria.where("state").is(state));
        }
        if (type != null) {
            query.addCriteria(Criteria.where("type").is(type));
        }
        if (priority != null) {
            query.addCriteria(Criteria.where("priority").is(priority));
        }
        return getMongoTemplate().find(query, Ticket.class);
    }
}

这种方式完全手动控制条件的添加，逻辑清晰，适合复杂场景。

• 确保接口参数未传时，后端接收的参数值为null（或Optional.empty()），如果框架默认给了枚举的默认值，会导致条件始终生效。
• 枚举类型要和MongoDB中存储的数值/字符串完全匹配，避免类型转换错误导致查询失效。

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