GridFsTemplate不支持按metadata等字段批量删除，必须先用MongoTemplate查询fs.files获取ObjectId列表，再调用delete()批量删除，且需分页限流、验证ID类型、确认fs.chunks同步清理。
GridFsTemplate 本身不支持按条件批量删除
Spring Data MongoDB 的 GridFsTemplate 提供了 delete() 方法，但它只接受 ObjectId 或 Query（基于 _id 字段），**不支持在 metadata、filename 或 uploadDate 上做任意查询后批量删**。你写 gridFsTemplate.delete(new Query(Criteria.where("metadata.userId").is("u123"))) 会静默失败——它根本不解析这个条件，最终什么也不删。
真正能生效的只有两种调用方式：
-
gridFsTemplate.delete(fileId)：传入一个ObjectId，删单个文件 -
gridFsTemplate.delete(query)：query 必须只含_id条件，例如new Query(Criteria.where("_id").in(idList))
所以想批量删“某个用户所有文件”，得先自己查出这批 _id，再喂给 delete()。
必须先查 fs.files 再删，且不能依赖 GridFsTemplate.find()
GridFsTemplate.find() 返回的是 GridFSFile 对象，它底层调用的是 GridFSBucket.find()，而后者**不支持嵌套字段查询**（比如 "metadata.userId"）。你加了条件也没用，它会忽略并返回全部文件。
正确做法是绕过 GridFsTemplate，直接操作底层 MongoTemplate 或原生 MongoDatabase：
- 用
mongoTemplate.findAll(FileDB.class, "fs.files")或更稳妥的mongoTemplate.find(Query.query(Criteria.where("metadata.userId").is("u123")), Document.class, "fs.files")拿到原始文档 - 从结果中提取所有
_id字段值（注意类型是ObjectId，不是字符串） - 把这一批
ObjectId组成列表，传给gridFsTemplate.delete(query)
别漏掉这一步：如果 metadata 中的 userId 是数字类型，但 Java 里传了字符串，查不到任何结果——先用 mongosh 确认真实存储类型。
删完 fs.files，fs.chunks 不会自动清理
这是最常被忽略的坑。GridFsTemplate.delete() 底层调用的是 GridFSBucket.delete()，它确实会先删 fs.chunks 再删 fs.files，**但前提是：你传进去的是合法 ObjectId，且该 ID 确实存在于 fs.files 中**。
如果你用 mongoTemplate.remove() 直接删 fs.files 文档，或者用 mongosh 执行 db.fs.files.deleteMany(...)，fs.chunks 会彻底变成孤儿块，磁盘空间不释放，后续也无法通过任何 GridFS API 清理。
所以必须坚持用 GridFsTemplate.delete()（或其底层 GridFSBucket.delete()），哪怕要多查一次数据库。
生产环境批量删前务必加限流和分页
一次删几千个文件，会阻塞 MongoDB 连接、拉高 CPU、触发慢日志，甚至拖垮副本集心跳。不要写 gridFsTemplate.delete(new Query(Criteria.where("_id").in(allIds))) 把上万 ID 一次性塞进去。
推荐分批处理，每批 100～500 个：
- 用
mongoTemplate.find()查时加limit(500)和skip分页 - 每次拿到一批
ObjectId后，调用gridFsTemplate.delete() - 每批之间加
Thread.sleep(50)或用ReactiveMongoTemplate做背压控制 - 记录已处理的最后
_id，避免因中断导致重复删或漏删
另外，GridFsTemplate 的 delete() 方法不会抛异常告诉你“某个 ID 不存在”，它只是跳过——所以删完最好反查确认数量是否匹配。
