Spring Data Mongo与Kotlin报错‘must be a compile-time constant’解决咨询

嘿，这个问题我之前也碰到过！确实和Kotlin里的$符号处理逻辑有关——Kotlin把字符串里的$当成字符串模板变量的标识，但Mongo查询里的$是操作符（比如$gt、$eq），两者撞车就会导致编译错误。下面给你几种靠谱的解决办法：

1. 用Kotlin原生字符串转义$ #

Kotlin的三重引号字符串（"""包裹）支持用$$来表示单个$字符，这样就能避免被当成模板变量解析。比如：

错误写法（会触发编译错误，因为Kotlin会把$gt当成未定义的变量）：

@Query("{ 'age': { $gt: ?0 } }")
fun findByAgeGreaterThan(age: Int): Flux<User>

正确写法（用$$转义Mongo的$操作符）：

@Query("""{ 'age': { $$gt: ?0 } }""")
fun findByAgeGreaterThan(age: Int): Flux<User>

如果是用普通双引号字符串，你需要用\$转义，但在Java注解的字符串里可能需要写\\$（因为Java层面也会解析一次转义），所以更推荐用三重引号的原生字符串，更直观。

2. 优先用方法名推导查询，完全避开$ #

Spring Data Mongo支持通过方法名自动生成查询语句，根本不用写@Query注解，既简洁又不会踩符号冲突的坑。比如上面的例子可以直接写成：

interface UserRepository : ReactiveCrudRepository<User, String> {
    // 框架会自动生成匹配age > ?0的Mongo查询
    fun findByAgeGreaterThan(age: Int): Flux<User>
}

常用的前缀像findBy、existsBy，搭配GreaterThan、LessThan、Contains这些关键字，基本能覆盖大部分简单查询场景，优先推荐这种方式。

3. 区分SpEL表达式和Kotlin模板变量 #

如果你的查询需要用到SpEL表达式（比如动态引用参数），注意用#而不是$，比如：

@Query("{ 'name': ?#{[0]} }")
fun findByName(name: String): Mono<User>

这里的#是SpEL的标识，和Kotlin的$模板变量完全不冲突，不会触发编译问题。

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