Spring Boot/Kotlin调用MongoDB Criteria API可空参数方法异常问题

问题原因 #

你遇到的"Expecting an element"异常，本质是Kotlin的语法特性导致的：is是Kotlin的保留关键字（用于类型检查），直接调用Java Criteria类的is(Object)方法时，编译器无法正确识别这是一个方法调用，进而引发语法解析错误。

两种可行的解决方式 #

1. 用反引号包裹方法名 #

Kotlin允许用反引号`将关键字作为方法名使用，以此强制编译器将其识别为Java方法调用：

query.addCriteria(Criteria.where("name").`is`("Bob"))

这种方式完全保留了Java API的原有调用逻辑，适合习惯原生API写法的场景。

2. 替换为等价的eq()方法 #

MongoDB Criteria API中，eq()方法和is()功能完全一致——都是用于匹配字段等于指定值，且同样支持可空参数。由于eq不是Kotlin关键字，直接调用即可：

query.addCriteria(Criteria.where("name").eq("Bob"))

这种写法更符合Kotlin的语法习惯，代码也更简洁。

处理可空参数的补充 #

如果你的参数是Kotlin的可空类型（比如String?），直接传入即可——Java的is(Object)和eq(Object)方法本身就支持接收null值，Kotlin会自动完成空值的装箱处理：

val nullableName: String? = "Alice"
// 用反引号调用is
query.addCriteria(Criteria.where("name").`is`(nullableName))
// 或者用eq
query.addCriteria(Criteria.where("name").eq(nullableName))

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