如何使用Quarkus Panache结合Mongo执行大小写不敏感搜索？

1. lower()无效返回全量数据的原因及修复 #

你用lower()函数无效是因为误用了SQL语法——Quarkus Panache for MongoDB遵循MongoDB原生查询规则，不支持SQL风格的lower()。这种情况下MongoDB会判定查询条件无效，直接返回所有文档。

下面是两种正确的实现方式：

方式1：正则表达式（简单场景首选） #

用MongoDB的正则匹配，加上大小写不敏感选项：

// 模糊匹配（类似SQL的 LIKE '%keyword%'）
List<YourEntity> results = find("name =~ ?1", Pattern.compile(keyword, Pattern.CASE_INSENSITIVE)).list();

// 精确匹配（类似SQL的 LOWER(name) = LOWER(keyword)）
Pattern exactPattern = Pattern.compile("^" + Pattern.quote(keyword) + "$", Pattern.CASE_INSENSITIVE);
List<YourEntity> exactResults = find("name =~ ?1", exactPattern).list();

方式2：MongoDB原生$toLower操作符（严格匹配场景） #

通过$expr表达式，将字段和关键词都转为小写后匹配：

List<YourEntity> results = find(
    "{$expr: {$eq: [{$toLower: '$name'}, ?1]}}", 
    keyword.toLowerCase()
).list();

2. 权威参考资源 #

• Quarkus官方文档的Panache for MongoDB板块：详细覆盖了Panache结合MongoDB的查询语法、自定义查询、聚合等操作，包含大小写不敏感、模糊搜索（等价SQL LIKE）的实现说明。
• MongoDB官方文档的查询操作符和正则表达式章节：Panache for MongoDB本质是封装MongoDB原生能力，掌握原生操作符能灵活实现各类搜索需求。
• Quarkus官方示例项目：里面有Panache MongoDB的各种查询场景代码，可直接参考范式。

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