直接在fs.files上建text索引可行但需满足三前提：集合非空、filename全为非空字符串、建索引后验证生效；否则索引无效导致搜不到结果。
直接在 fs.files 上对 filename 建 text 索引可行，但必须满足三个前提：集合非空、filename 全是字符串、索引创建后验证生效——否则查不到结果不是语法错，而是索引压根没起作用。
为什么 db.fs.files.createIndex({filename: "text"}) 有时返回成功却搜不出东西
常见原因不是命令写错，而是 MongoDB 的 text 索引对文档内容有硬性要求：如果 fs.files 里存在 filename: null、filename: 123 或空字符串的文档，这些文档会被跳过，不参与索引构建；更隐蔽的是，刚初始化的空集合执行该命令会静默成功，但实际没建出可用索引。
- 先确认集合有真实数据：
db.fs.files.countDocuments({ filename: { $type: "string", $ne: "" } })至少返回 >0 - 清理异常值：
db.fs.files.updateMany({ filename: { $not: { $type: "string" } } }, { $set: { filename: "" } }) - 别用
db.fs.files.createIndex(...)别名，显式写db["fs.files"].createIndex(...)，避免驱动层解析歧义 - 建完立刻验证：
db["fs.files"].find({ $text: { $search: "test" } }, { score: { $meta: "textScore" } }).limit(1)—— 结果里必须有score字段，否则索引未激活
中文/多语言文件名搜索必须指定 default_language
MongoDB 默认用英文分词器，对中文会按单字切分（“报告” → “报”“告”），导致召回率极低。4.2+ 版本启用 ICU 后可支持中文分词，但需手动指定语言参数，否则 $text 查询基本无效。
- 纯中文场景：
db["fs.files"].createIndex({ filename: "text" }, { default_language: "zh" }) - 中英混合（如“Q3_季度报告_v2.pdf”）：
db["fs.files"].createIndex({ filename: "text" }, { default_language: "none" })，此时按空格和标点分词，不依赖语言规则 - 避免用
language_override: "lang"字段——它只在文档里显式含lang: "zh"才生效，而 GridFS 不自动写这个字段 - 注意：
default_language: "zh"仍无法处理拼音，“北京”搜不到“beijing”，得前端额外存filename_pinyin字段并加索引
$text 查询不能替代 $regex，但能规避全表扫描
$text 和 $regex 是两类查询：前者走倒排索引，快但只支持关键词匹配；后者走文档扫描，慢但支持任意模式。很多人想用 $text 实现 "report.*2023" 这种正则逻辑，这不可能。
-
$text不支持前缀通配（"季*"）、不支持正则语法、不支持跨词顺序（"2023 报告"可能不命中"报告2023"） - 真要模糊前缀匹配，且文件名有结构（如
"2023-10-report.pdf"），优先建普通索引：db["fs.files"].createIndex({ filename: 1 })，再用{ filename: { $gte: "2023-10", $lt: "2023-11" } } - 若必须同时支持关键词 + 前缀，建两个索引：
{ filename: "text" }用于$text，{ filename: 1 }用于范围查询，MongoDB 会按需选一个 -
$text查询必须配合$meta: "textScore"投影才能排序，否则结果无相关性保障：.find({ $text: { $search: "发票" } }, { score: { $meta: "textScore" } }).sort({ score: { $meta: "textScore" } })
最易被忽略的一点：GridFS 的 filename 字段长度上限是 1024 字节，超长文件名会被截断入库——这意味着你索引的可能只是“xxx...（截断）”，分词和搜索都从源头失真。业务上若允许，强制前端限制文件名长度；若不允许，就得接受搜索失效风险，这时候该换 Elasticsearch 了。
