必须用驱动自带的rename()方法而非updateOne()修改filename——因后者破坏filename与uploadDate等字段的关联定位逻辑，且可能触发唯一索引冲突或漏掉多版本协调。
不能用 updateOne() 直接改 filename 字段 —— 看似成功，但后续读取大概率失败。
为什么 updateOne() 修改 fs.files.filename 会出问题
常见现象是调用 collection.updateOne() 返回 matchedCount: 1, modifiedCount: 1，但用 openDownloadStream() 找不到文件，或下载时报 FileNotFound。
- 驱动内部查询逻辑常依赖
filename+uploadDate或其他字段组合做去重/版本匹配；单改filename会让客户端无法定位原文件 - MongoDB 6.0+ 默认对
fs.files.filename加了唯一索引（尤其在启用bucketName自定义索引时），直接 update 可能触发duplicate key错误 - 某些驱动（如旧版 PyMongo）的
rename()底层是“删旧 + 插新”，而非原子更新；手动绕过 API 改fs.files，容易漏掉关联逻辑（比如多版本同名文件的处理）
必须用驱动自带的 rename() 方法
所有主流官方驱动（Node.js、Python、Go、Java）都为 GridFSBucket 提供了原子性 rename()，它会协调 fs.files 更新、索引刷新和多版本兼容逻辑。
- Node.js：
await bucket.rename(oldId, newName)，注意第一个参数是_id（ObjectId），不是旧文件名 - PyMongo：
bucket.rename(old_file_id, new_filename)，同样传ObjectId，不是字符串名 - Go driver：
bucket.Rename(ctx, oldID, newName)，oldID类型为primitive.ObjectID - Java：
gridFSBucket.rename(oldObjectId, newFilename)，不接受字符串旧名
重命名前必须先查出文件的 _id
你不能只靠旧文件名去 rename —— 因为同名文件可能有多个（多次上传），rename() 要求明确指定目标文档的 _id。
- 先用
find({ filename: "old.pdf" })查出文档，取其_id字段 - 如果存在多条，需结合
uploadDate、metadata或业务字段筛选出你要改的那个 - 不要用
findOne({ filename: "old.pdf" })后直接 rename —— 若有多个同名文件，结果不可控
最易被忽略的一点：重命名操作本身不改变文件内容或 chunk 数据，但驱动必须通过 _id 定位到唯一文件记录；跳过查 _id 这步，等于把 rename 当成了“按名批量改名”，这在 GridFS 中不成立。
