使用 mongodump 与 mongorestore 不能直接完成 GridFS 文件迁移，必须明确导出 fs.files 和 fs.chunks 两个集合，并严格保证它们之间的关联关系、写入顺序以及索引一致。否则，很容易出现文件损坏、内容缺失或读取失败等问题。
mongodump + mongorestore —— 它们默认不会处理 .files 与 .chunks 集合之间的关联关系，容易造成 chunk 丢失、元数据错位，最终引发文件损坏或无法读取。
最安全、最可靠的迁移方案，取决于实际迁移场景：同库跨桶、同集群跨库、跨集群迁移。三种场景分别对应不同做法，方法选错往往意味着需要重新迁移。
同数据库内 GridFS 桶间迁移（如 bucket1 → bucket2）
这是唯一可以绕过 GridFS API、直接操作底层集合的迁移场景，通常具备更高性能，同时也更容易保证原子性。
- 必须显式访问
bucket1.files和bucket1.chunks两个集合，不能直接使用GridFSBucket实例的find()或openDownloadStream()—— 因为这些接口不会暴露 chunk 的底层关联逻辑 - 迁移步骤不能颠倒：应先写入
bucket2.files，再按相同的_id批量查询bucket1.chunks并插入到bucket2.chunks；否则bucket2.chunks中的files_id会引用不存在的文件文档 - 要特别注意
chunk文档中的n字段必须保持原有顺序，否则在重组文件时会发生顺序错乱；而mongorestore不保证插入顺序，因此建议使用insertMany()，并确保列表顺序与源数据完全一致 - Java 示例中如果通过
into(new ArrayList<>())获取 chunk 列表，需要确认所用驱动版本支持有序返回（4.11+ 默认保序，4.7–4.10 则需要显式加上.sort("n", 1)）
跨数据库但同 MongoDB 集群迁移（如 db1.bucket → db2.bucket）
这种情况下，不能直接复用同库迁移逻辑，因为类似 db.getCollection("db1.bucket.files") 的写法在驱动中并不合法——集合名称本身不应包含数据库前缀。
- 必须分别获取两个数据库实例：
MongoDatabase db1 = client.getDatabase("db1");、MongoDatabase db2 = client.getDatabase("db2"); - 然后分别通过
db1.getCollection("bucket.files")和db2.getCollection("bucket.files")获取对应集合，注意这里的集合名只是纯字符串，不包含数据库名 - 权限必须同时覆盖源库和目标库：用户需要对
db1拥有read权限，对db2拥有readWrite权限；仅有root角色不一定完全适用，建议显式授权：db.grantRolesToUser("migrator", [{role:"read", db:"db1"}, {role:"readWrite", db:"db2"}]) - 在插入 chunk 之前，建议先检查目标
bucket.chunks是否为空，以避免重复 ID 冲突；同时，跨库场景下in("_id", ...)查询依然可用，但files_id的字段类型必须与目标bucket.files中的_id完全一致（例如都为ObjectId，不能与字符串混用）
跨 MongoDB 集群迁移（含 Atlas、自建、不同版本）
在这种场景下，通常无法继续依赖底层集合直连方式，只能回到工具链方案，但 mongodump/mongorestore 本身存在不少容易忽略的细节和风险。
mongodump --db mydb --collection mybucket.files只会导出文件元数据，mybucket.chunks必须显式单独导出，否则恢复后只会剩下无法使用的空壳文件mongorestore不会自动重建 GridFS 关联：它只是把.files和.chunks当作普通集合导入，不会触发 GridFS 的一致性校验；因此必须保证导入后的.chunks中files_id与.files中_id严格匹配，包括类型、具体值以及大小写- 如果源集群是 MongoDB 6.0+，目标环境为 Atlas，优先建议使用 Atlas 控制台提供的“实时迁移（拉取）”功能 —— 它能够识别 GridFS 结构并执行 chunk 关联校验，相比手动 dump/restore 能显著降低出错概率
- 如果必须使用命令行工具，恢复时建议加上
--drop参数先清空目标 bucket 再执行 restore，否则已有文件 ID 发生冲突时，可能导致部分 chunk 被跳过（mongorestore默认不会覆盖已有数据）
chunk 中 data 字段的二进制完整性。无论采用哪种 GridFS 迁移方式，迁移完成后都应进行抽样校验：使用 GridFSBucket 从新位置打开文件，调用 downloadToStream()，并与原始 MD5 进行比对——仅仅看到文档数量一致并不能说明迁移成功，一旦 chunk 损坏或顺序错位，文件依然可能无法打开，或者出现内容截断。
