GridFS不支持原生tags字段，需将字符串数组存入metadata对象；查询单标签用$in，多标签交集用$all，去重需手动读取-处理-更新。
GridFS 元数据不支持原生 Tags 字段，但可以用 metadata 里的数组模拟
GridFS 本身没有 tags 这个保留字段，所有自定义元数据都得塞进 metadata 对象。MongoDB 不限制 metadata 的结构，所以你可以放心用数组存标签，比如 ["prod", "report", "v2"]。注意：这个数组必须是字符串数组（或统一类型的值），避免混用数字、布尔、嵌套对象——否则按标签查时会因类型不一致漏匹配。
插入文件时写入标签数组要显式指定 metadata 对象
用 gridfs-bucket.uploadFromStream() 或 put() 时，不能只传一个 tags 数组，必须把它包进 metadata 里。常见错误是直接传 { tags: ["a", "b"] }，结果发现字段没存进去——因为驱动只认顶层的 metadata 键。
正确做法：
bucket.uploadFromStream(
"report-2024.pdf",
stream,
{
metadata: {
tags: ["pdf", "monthly", "finance"],
uploadedBy: "user_123",
version: 1
}
}
)
按单个 Tag 查询需要使用 $in 而不是 $eq
tags 是数组，哪怕你只想找含 "pdf" 的文件，也不能写 { "metadata.tags": "pdf" } ——这在语义上是“整个数组等于字符串”，永远不成立。必须用 $in 或 $elemMatch。
-
{ "metadata.tags": { $in: ["pdf"] } }—— 简洁，适合单值匹配 -
{ "metadata.tags": "pdf" }—— 表面看能查，实为隐式$eq数组元素，依赖 MongoDB 的数组包含匹配机制，但可读性差、易误解 -
{ "metadata.tags": { $elemMatch: { $eq: "pdf" } } }—— 冗余，$in更直白
多标签交集查询（如同时含 "pdf" 和 "finance"）要用 $all：{ "metadata.tags": { $all: ["pdf", "finance"] } }。
标签去重和更新需手动处理，GridFS 不提供原子级数组去重操作
如果业务允许重复打标（比如多次调用“加标签”接口），metadata.tags 可能出现 ["pdf", "pdf", "report"]。MongoDB 没有类似 $addToSet 对嵌套数组的原生支持——$addToSet 只作用于顶层字段。所以得先 find 出来，JS 侧去重，再 updateOne 写回。
安全更新建议：
- 读取当前文档：
bucket.find({ _id: fileId }).toArray() - 在内存中合并并去重：
Array.from(new Set([...existingTags, ...newTags])) - 用
bucket.files.updateOne()更新metadata.tags字段（注意只更新files集合，chunks不动）
这一步容易被忽略：直接 $push 而不做去重，会导致标签膨胀；用 $set 全量覆盖又可能丢掉其他元数据字段（如 uploadedBy）。务必用 $set: { "metadata.tags": dedupedArray }，而不是替换整个 metadata。
