GridFS是文件存储方案而非报表生成工具；它仅存取已生成的PDF、Excel等文件，不参与渲染，需先由EasyExcel等引擎生成字节数组再交由GridFsTemplate存储。
GridFS不是报表生成工具，而是文件存储方案；它只负责存/取已生成的PDF、Excel等报表文件，不参与渲染逻辑。
为什么不能直接用 GridFsTemplate 生成报表
常见误解是把 GridFsTemplate 当作“报表引擎”，但它只是一个 MongoDB 的二进制文件存取适配器。它没有模板解析能力，也不处理数据绑定、HTML转PDF、Excel填充等动作。所有报表内容必须先由其他组件（如 EasyExcel、Thymeleaf + Flying Saucer 或 UReport2）生成为字节数组或输入流后，才能交给 GridFsTemplate 存储。
- 错误做法：
gridFsTemplate.store(new ByteArrayInputStream(...), "report.pdf")中传入未生成的空流或错误编码的字符串 - 正确链路：业务数据 → 报表引擎 →
byte[]或InputStream→GridFsTemplate.store() - 遗漏点：很多项目忘记在存储前设置
contentType和metadata，导致前端下载时无法识别格式或丢失原始文件名
GridFsTemplate 存储报表文件的关键参数
调用 store() 时，必须显式控制三个核心参数，否则后续下载、预览、清理都会出问题：
-
filename：建议带时间戳和业务标识，例如"sales_report_202610201730.pdf"，避免重名覆盖 -
contentType：严格匹配实际内容，PDF 必须是"application/pdf"，Excel 是"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"，不能写成"text/plain"或留空 -
metadata：用Document封装业务字段，比如{"reportType": "SALES", "userId": "U1001", "period": "2026-10"}，这是后续按条件查询报表的唯一依据
示例片段（非完整类）：
Document metadata = new Document()
.append("reportType", "FINANCIAL")
.append("userId", userId)
.append("generatedAt", Instant.now());
ObjectId fileId = gridFsTemplate.store(
inputStream,
filename,
"application/pdf",
metadata
);
如何安全地按业务条件查询并下载报表
不能依赖 filename 做模糊查询——MongoDB 对 fs.files.filename 字段默认无索引，大数据量下会全表扫描。必须利用 metadata 字段并建立复合索引：
- 索引命令（在 MongoDB Shell 中执行）：
db.fs.files.createIndex({"metadata.reportType": 1, "metadata.userId": 1, "uploadDate": -1}) - Java 查询示例：
Query query = Query.query(Criteria.where("metadata.reportType").is("SALES").and("metadata.userId").is(userId)); - 务必校验
GridFSFile是否存在且非空，再调用gridFsTemplate.getResource(fileId)获取流，否则抛IllegalArgumentException - 注意：
getResource()返回的是GridFSResource，其getInputStream()只能读一次，多次调用会返回空流
临时报表与正式报表的桶分离策略
生产环境强烈建议用不同 bucket 区分用途，避免误删或权限混用：
- 临时报表（如导出预览、调试用）：使用自定义 bucket 名
"tmp_reports"，对应集合为tmp_reports.files和tmp_reports.chunks - 正式报表（归档、审计用）：使用
"reports"bucket，并开启 TTL 索引自动过期（如 90 天）：db.reports.files.createIndex({"uploadDate": 1}, {"expireAfterSeconds": 7776000}) - 配置方式：通过
@Bean定义多个GridFsTemplate实例，分别注入不同GridFsOperations（基于不同GridFsTemplate构造参数）
最容易被忽略的一点：同一个 MongoDB 连接下，多个 bucket 共享同一套连接池和事务上下文，但删除操作（delete()）不会跨 bucket 生效——删 tmp_reports 不会影响 reports，这点必须在测试中验证，不能凭经验假设。
