Spring Mongo @Query校验前端空值时语法错误排查求助

错误原因 #

你使用$where: '?0 == null'的写法存在问题：$where执行的是MongoDB的JavaScript代码，而?0是Spring Data的参数占位符，直接写在JS字符串里会被MongoDB当作JS标识符解析，但JavaScript不允许标识符以数字开头，因此触发了语法错误。

推荐解决方案：用SpEL表达式简化@Query #

Spring Data MongoDB支持在@Query中使用SpEL表达式，直接判断参数是否为null，为空时返回空文档（不生效条件），非空时添加匹配条件，写法简洁且避免JS语法问题：

@Query("{$and: ["
        + "?0 == null ? {} : {name: ?0},"
        + "?1 == null ? {} : {batch: ?1},"
        + "?2 == null ? {} : {city: ?2}"
        + "]}")
List<YourEntity> findByParams(String name, String batch, String city);

替代方案：动态构建Query（更灵活） #

如果需要更复杂的动态查询逻辑，直接用MongoTemplate构建Query对象，可读性和扩展性更好：

@Autowired
private MongoTemplate mongoTemplate;

public List<YourEntity> findByParams(String name, String batch, String city) {
    Query query = new Query();
    if (name != null) {
        query.addCriteria(Criteria.where("name").is(name));
    }
    if (batch != null) {
        query.addCriteria(Criteria.where("batch").is(batch));
    }
    if (city != null) {
        query.addCriteria(Criteria.where("city").is(city));
    }
    return mongoTemplate.find(query, YourEntity.class);
}

原写法不可行的核心原因 #

$where通过执行JS代码过滤文档，性能远低于原生查询操作符；且你直接将Spring的占位符?0嵌入JS字符串，MongoDB解析JS时会把?0当作无效标识符（JS变量不能以数字开头），这就是报错的直接诱因。

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