如何在Eve框架中对MongoDB数组字段实现全文搜索及配置停用词？

一、先排查文本索引查询无响应的问题 #

你遇到的查询无响应/无结果的情况，大概率是索引没正确创建、查询语法有问题，或者数据不匹配导致的，咱们一步步来：

1. 验证索引是否真的创建成功
   Eve的mongo_indexes配置并不会自动帮你创建索引（除非你开了自动创建开关），尤其是当集合已经存在的时候。你可以直接登录MongoDB Shell，切换到对应数据库后执行：

db.names.getIndexes()

看看返回的列表里有没有包含first_names.starting_letter字段的text类型索引。如果没有，那就是索引没建好，这时候有两种解决方式：

• 开启Eve的自动创建索引：在你的Eve配置文件里添加MONGO_AUTO_CREATE_INDEXES = True，然后重启服务，Eve会自动根据mongo_indexes配置创建索引。
• 手动创建索引：在MongoDB Shell里执行：

db.names.createIndex({"first_names.starting_letter": "text"})

2. 检查查询语法与编码
   你用的查询URL里，where参数的JSON字符串用了"转义，虽然语法上没问题，但有时候URL编码可能会出问题。你可以试试两种方式测试：

• 把JSON直接URL编码后传入，比如{"$text": {"$search": "if"}}编码后是%7B%22%24text%22%3A%20%7B%22%24search%22%3A%20%22if%22%7D%7D，完整URL就是：
  localhost:5000/api/v1/names?where=%7B%22%24text%22%3A%20%7B%22%24search%22%3A%20%22if%22%7D%7D
• 改用POST请求，把查询条件放在请求体的JSON里（Eve默认支持POST查询），这样能避免URL编码的问题。

另外，还要确认你的Eve版本是否支持MongoDB的$text操作符，建议升级到最新的稳定版，旧版本可能对部分MongoDB查询语法支持有限。

3. 确认数据是否匹配查询条件
   最后别忘了检查names集合里的文档：first_names.starting_letter字段存储的是什么内容？如果这个字段是单个字母（比如字段名暗示的那样），那搜索"if"这种双字母关键词肯定匹配不到，这时候查询自然没结果。

二、停用词的配置方式 #

Eve本身不直接提供停用词配置入口，因为停用词是MongoDB文本索引的原生配置项，所以最优方案是在创建文本索引时指定停用词，而不是在前端处理：

1. 在MongoDB层面配置停用词
   创建索引时可以通过stopwords参数指定自定义停用词列表，比如：

db.names.createIndex(
    {"first_names.starting_letter": "text"},
    {
        "default_language": "english",
        "stopwords": ["a", "an", "the", "if"]  # 这里放你的自定义停用词
    }
)

2. 在Eve的mongo_indexes里配置
   如果你想让Eve自动创建带停用词的索引，可以修改mongo_indexes的配置，把索引参数也加上：

'mongo_indexes': {
    'text': (
        [('first_names.starting_letter', 'text')],
        {'default_language': 'english', 'stopwords': ['a', 'an', 'the', 'if']}
    )
}

记得要开启MONGO_AUTO_CREATE_INDEXES = True，并且如果之前已经创建过text索引，需要先删除旧索引再重启服务，不然新的配置不会生效。

3. 前端/Eve钩子层处理（备选）
   如果因为某些原因无法在MongoDB层面配置，也可以在前端发送请求前过滤掉停用词，或者在Eve的pre_GET钩子函数里处理：
   比如在Eve的钩子中获取where参数里的搜索关键词，拆分后过滤掉停用词，再重新构造查询条件，这样MongoDB收到的就是已经过滤后的关键词了。

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