Java/Spring中如何实现MongoDB高性能不区分大小写查询

你触发警告的核心原因是：带i选项的$regex操作符不会感知集合/索引的collation规则，哪怕你提前建了不区分大小写的普通索引，这种写法也完全无法命中索引，会触发全表扫描，性能极差。

性能从高到低依次为：Atlas Search全文检索 > 带collation的等值匹配 > 带collation的前缀正则匹配 > 带i选项的普通$regex匹配，其中最后一种是你当前在用的最差实现。 #

方案1：性能最优（官方推荐）：使用Atlas Search做不区分大小写搜索 #

如果你的业务是任意位置的模糊/包含匹配、全文检索场景，直接用Atlas Search是最优解，不需要依赖普通集合索引，性能远高于正则实现：

• 先在Atlas控制台给目标集合创建Search索引，将需要搜索的search字段映射为string类型即可，开启动态映射的话可以跳过手动配置。
• Java侧替换原有Criteria正则逻辑为聚合管道的$search阶段，Spring Data Mongo实现示例：

import org.springframework.data.mongodb.core.aggregation.Aggregation;
import org.springframework.data.mongodb.core.aggregation.AggregationOperation;
import static org.springframework.data.mongodb.core.aggregation.SearchOperation.search;
import static org.springframework.data.mongodb.core.aggregation.SearchQuery.text;

// 构造搜索阶段，默认不区分大小写
AggregationOperation searchStage = search(
    text(data.getText()).path("search")
);
Aggregation aggregation = Aggregation.newAggregation(searchStage);
// 直接执行聚合查询即可，自动命中Search倒排索引

该方案优势：

• 完全不会触发官方警告，哪怕是任意位置的包含匹配、长文本检索，性能都比正则高几个量级
• 原生支持分词匹配、容错搜索、近义词匹配等高级搜索能力，不需要额外写正则逻辑

方案2：不使用Atlas Search时，正确配置Collation走普通索引 #

如果你的场景是简单等值/前缀匹配，不想引入Search能力，可以按以下步骤配置collation，注意：collation仅支持等值匹配、前缀正则匹配走索引，任意位置的包含匹配依然会全表扫描，这种场景必须用方案1。

第一步：创建带collation规则的索引 #

建索引时指定的collation参数必须和后续查询传入的参数完全一致，否则无法命中索引。示例（Mongo Shell执行）：

db.你的集合名.createIndex(
  { search: 1 },
  {
    // locale根据业务语言选择，中文填zh、英文填en即可
    collation: { locale: "zh", strength: 1 }
    // strength=1 表示完全不区分大小写、不区分重音符号；strength=2 表示不区分大小写但区分重音，按业务需求选
  }
)

第二步：Java侧代码改造 #

根据你的匹配场景选对应写法，所有写法都不要给regex加i选项，大小写不敏感逻辑完全由collation处理：

1. 等值匹配场景（搜索值和字段值完全一致，仅大小写不同）：性能最高，100%命中索引

import org.springframework.data.mongodb.core.query.Collation;
import org.springframework.data.mongodb.core.query.Criteria;
import org.springframework.data.mongodb.core.query.Query;

Criteria criteria = Criteria.where("search").is(data.getText());
Query query = Query.query(criteria)
    // 传入的collation必须和建索引时的参数完全一致
    .collation(Collation.of("zh").strength(Collation.ComparisonLevel.primary()));
return query;

2. 前缀匹配场景（比如搜索"test"匹配"test123"、"TestAbc"，不匹配"xxtest"）：可以命中索引

import java.util.regex.Pattern;

// 用Pattern.quote转义用户输入的正则特殊字符，避免查询逻辑异常
String prefixPattern = "^" + Pattern.quote(data.getText());
Criteria criteria = Criteria.where("search").regex(prefixPattern); // 不要传"i"选项
Query query = Query.query(criteria)
    .collation(Collation.of("zh").strength(Collation.ComparisonLevel.primary()));
return query;

• 不要试图给非前缀正则（比如.*xxx.*这种任意位置包含的写法）加collation，这种写法Mongo无法命中B树索引，数据量稍微大一点就会出现严重的性能问题
• 建索引和查询时的collation参数必须完全一致，包括locale、strength等所有配置，差一个参数都不会走索引
• 如果你用的是MongoDB社区版不是Atlas，没有Atlas Search能力，任意位置的不区分大小写包含匹配可以考虑额外存一个全大写字段，匹配时把搜索词转大写后做前缀/等值匹配，性能比正则高

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