gridfstemplate不支持application.properties动态切换bucket，必须手动声明多个@bean并显式传入bucket名；spring.data.mongodb.grid-fs-database仅对gridfsbucket有效，对gridfstemplate无效。
GridFsTemplate 不支持 application.properties 动态切换 bucket
Spring Boot 的自动配置只提供一个绑定 fs 桶的 GridFsTemplate，且完全忽略 spring.data.mongodb.grid-fs-database 配置项。这个配置只对 GridFSBucket.builder().build() 有效，对 GridFsTemplate 构造器无任何作用。
想让同一个应用写入 tempFs、backup、files 等不同 bucket，必须手动声明多个 @Bean，并在构造时显式传入 bucket 名字符串 —— 它会直接决定操作哪组集合：db_name.bucket_name.files 和 db_name.bucket_name.chunks。
- 不传第三个参数（bucket 名），等价于
new GridFsTemplate(..., "fs")，永远写进fs - 传
"tempFs"，实际操作的是test.tempFs.files（假设spring.data.mongodb.database=test） - 每个 bean 必须用
@Bean(name = "tempGridFsTemplate")显式命名，否则@Autowired会因类型冲突失败
手动注册多个 GridFsTemplate bean 的正确写法
不能用 @Primary 覆盖默认 bean，否则会导致 GridFSBucket 注入失败；也不能靠条件注解（如 @ConditionalOnProperty）动态开关 bean，因为 Spring 容器启动后 bean 就已固定。
真正“动态”的做法是：定义一个工厂类，按需返回对应 bucket 的 GridFsTemplate 实例，底层复用同一个 MongoDbFactory 和 MappingMongoConverter。
- 示例工厂方法：
public GridFsTemplate getGridFsTemplate(String bucket) { return new GridFsTemplate(mongoDbFactory, mappingMongoConverter, bucket); } - 调用时传入 bucket 名即可：
getGridFsTemplate("tempFs")→ 操作tempFs桶 - 避免每次 new 实例带来的开销？可加简单缓存（ConcurrentHashMap
），key 为 bucket 名 - 注意：该实例不参与 Spring 生命周期管理，不走 AOP，但对 GridFS 场景够用
contentType 和 metadata 的硬性约束必须手写校验
GridFsTemplate.store(InputStream, String, String, Document) 第三个参数是 contentType，不是扩展名，也不可为 null 或空字符串。若传错，MongoDB 会存入 contentType: null，后续用 findByContentType() 查不到。
metadata 字段名不能含 . 或 $，否则插入时抛 IllegalArgumentException；值里的时间、枚举等类型不会走 Spring Data 的序列化链路，必须手动转成基础类型。
-
LocalDateTime→ 推荐转毫秒：time.atZone(ZoneOffset.UTC).toInstant().toEpochMilli() - 枚举 → 统一用
myEnum.name()，别用ordinal() - 构建
metadata优先用Document.parse("{\"type\":\"log\",\"env\":\"prod\"}")，避免BasicDBObject（新版本已弃用） - 文件名（第二个参数）仅存入
filename字段，MongoDB 不校验唯一性，同名文件共存，靠_id区分
真正推荐的“动态多源”路径其实是 GridFSBucket
GridFsTemplate 在 Spring Data MongoDB 3.0+ 已被标记为 @Deprecated，官方倾向使用原生驱动的 GridFSBucket。它更轻量、可控，且天然支持运行时动态指定 bucket 和 database。
关键点：它依赖 MongoDatabase，不是 MongoTemplate；创建方式只能是 GridFSBuckets.create(database, bucket)，不能 new。
- 你可以从
MongoClient拿任意MongoDatabase（比如根据租户 ID 动态选库），再传 bucket 名生成GridFSBucket - 例如：
GridFSBuckets.create(client.getDatabase("tenant_a"), "files") - 上传时
uploadFromStream()接收Document元数据，字段可直接建索引提升查询性能 - 下载必须流式处理（
openDownloadStream()），否则大文件容易 OOM
所谓“动态多数据源”，本质是运行时拼出正确的 MongoDatabase + bucket 组合，而不是在 Spring 容器里堆一堆预定义 bean。这点最容易被忽略，也最影响后期扩展性。
