GridFS不支持多语言语义化存储，metadata中lang字段需应用层约定并统一键名、校验格式；必须手动创建索引db.fs.files.createIndex({"metadata.lang": 1})；全文检索需另建带语言标记的文本摘要集合。
GridFS 本身不支持多语言文档的语义化存储
GridFS 是纯二进制文件系统，fs.files 中的 metadata 字段只是任意 JSON 对象，MongoDB 不会解析、索引或校验其中的 lang 字段。你写 {"lang": "zh-CN"} 或 {"language": "ja"} 都可以，但除非你主动在应用层约定并使用它，否则它对查询、排序、全文检索毫无作用。
在 metadata 里存 lang 必须自己定义结构并保持一致
常见错误是混用键名：lang、language、locale、code 全部出现，导致后续 find({ "metadata.lang": "en" }) 查不到部分文件。建议统一用 lang（小写、ISO 639-1 格式），并在所有上传路径强制校验：
- 上传前检查
lang值是否匹配正则/^[a-z]{2}(-[A-Z]{2})?$/（如"en"、"pt-BR"） - 拒绝空值、null、非字符串类型
- 避免在
metadata里嵌套过深，例如不要用{"i18n": {"lang": "fr"}}，直接用{"lang": "fr"}
示例正确写法（Node.js）：
const uploadStream = bucket.openUploadStream('report.pdf', {
metadata: { lang: 'de', version: '2026-Q2', author: 'anna' }
});
按语言查文件必须配合 find() + 显式索引
默认 fs.files 没有为 metadata.lang 建索引，大量文件时查询会全表扫描。必须手动创建：
db.fs.files.createIndex({ "metadata.lang": 1 })
注意：MongoDB 不支持对 metadata 内部字段做稀疏索引自动过滤缺失项，所以如果有些文件没写 lang，它们仍会被包含在索引中（值为 null）。如需严格隔离，上传时务必确保所有目标文件都含该字段。
别指望 lang 能触发 MongoDB 全文搜索
MongoDB 的 $text 索引只作用于字符串字段（如 content、title），且依赖 language 参数指定分词规则。你在 metadata.lang 里写 "ar"，并不会让 GridFS 自动用阿拉伯语分词去搜文件内容——因为 GridFS 根本不索引文件内容本身，它只存二进制块。
真正要实现多语言文本检索，得另存一份带语言标记的文本摘要到普通集合，例如：
{ _id: ObjectId("..."), fileId: ObjectId("..."), lang: "es", excerpt: "Informe mensual de ventas..." }
然后在这个集合上建 { excerpt: "text", lang: 1 } 复合索引。
最常被忽略的一点：GridFS 的 metadata 是只读附加信息，无法原子更新。改一个 lang 值，本质是删旧文件 + 传新文件，files_id 会变。别把它当普通文档字段来“编辑”。
