如何通过注解在Spring Data MongoDB中定义带默认语言的通配符文本索引

你的问题出在@CompoundIndex注解的使用方式上——你试图在def属性中同时传入索引键和选项，但Spring Data MongoDB的def字段仅用于定义索引的键结构，而文本索引的选项（比如default_language）需要通过注解的专属属性来配置。

正确的注解写法 #

直接使用@CompoundIndex的language属性指定默认语言即可，不需要在def里拼接选项JSON：

@Document(collection = "events")
@CompoundIndexes({
    @CompoundIndex(
        name = "fulltext",
        def = "{'$**':'text'}",
        language = "german"
    )
})
public class Event {
    public Event() { }
    protected String name;
    // 其他字段省略...
}

为什么之前的写法无效？ #

MongoDB原生的createIndex是分两个参数的（键定义 + 选项），但Spring Data MongoDB的@CompoundIndex注解把这两部分拆成了不同的属性：

• def：负责描述索引的键（比如{'$**':'text'}）
• language：对应MongoDB的default_language选项
• 还有languageOverride等属性，对应文本索引的其他选项

你之前把键和选项写成两个独立的JSON对象传给def，Spring Data只会解析第一个对象作为键定义，第二个对象会被忽略，导致default_language设置不生效。

验证效果 #

用这种方式配置后，Spring Data会自动生成和你在Mongo Shell中执行的等价命令：

db.events.createIndex({'$**':'text'},{default_language: "german"})

这样既保留了你想要的注解式优雅写法，又能正确设置文本索引的默认语言。

内容的提问来源于stack exchange，提问作者Paul K.