mongofiles upload 一次只能传一个文件，批量导入需用 shell 脚本遍历文件夹逐个调用；官方不支持目录递归，硬指定目录会报“is a directory”错误；linux/macos 推荐 for 循环或 find + -print0 避空格，windows 应用 powershell + get-childitem；务必加 --replace 防重复，并显式指定 --db 和 --host。
mongofiles upload 一次只能传一个文件，怎么批量导入整个文件夹
直接用 shell 脚本遍历文件再逐个调用 mongofiles 是最稳妥的方案。MongoDB 官方工具不支持原生文件夹递归上传，硬套 --file 指向目录会报错：error: cannot open file: /path/to/dir (Is a directory)。
实操建议：
- Linux/macOS 下用
find+xargs或for循环，避开空格路径问题（加引号或用-print0） - Windows 命令行能力弱，推荐用 PowerShell：用
Get-ChildItem -Recurse遍历，再对每个$file.FullName调用mongofiles --host ... put "$file" - 务必先测试单个文件是否能成功上传，确认
mongofiles版本与 MongoDB 服务兼容（如 MongoDB 6.0+ 推荐用 6.x 版本的 mongofiles）
上传时如何控制 GridFS 的 filename、chunkSize 和 metadata
mongofiles 默认把本地文件名作为 GridFS 的 filename 字段，但无法通过命令行设置自定义 metadata 或修改 chunkSize —— 这两个参数必须用驱动代码（如 PyMongo、Node.js mongodb driver）才能指定。
能控制的只有：
-
--local <name></name>：重命名上传后的文件名（即覆盖默认的filename），例如mongofiles --local report.pdf put invoice.pdf会让 GridFS 中存为invoice.pdf，但实际内容是report.pdf -
--chunkSize <bytes></bytes>：仅在put时生效，单位是字节，必须是 255KB 的整数倍（GridFS 协议限制），例如--chunkSize 524288表示 512KB - 不加
--db参数时，默认写入test数据库；--db myfiles可指定目标库，对应 GridFS 的myfiles.fs.files和myfiles.fs.chunks集合
上传失败常见原因和排查顺序
批量上传中途卡住或报错，优先检查这三项：
-
connection refused或auth failed：确认--host地址、端口（默认 27017）、--username/--password和--authenticationDatabase是否匹配服务端配置；MongoDB 4.0+ 默认启用 SCRAM-SHA-256 认证，旧版 mongofiles 可能不兼容 -
file already exists：mongofiles put默认不覆盖，加--replace才能更新同名文件（注意：这是删除旧文件再上传新文件，不是增量更新） - 大文件上传中断后残留部分 chunks：手动清理需删掉
fs.files中对应文档，并删掉fs.chunks中所有files_id匹配的 chunk 文档；建议上传前用mongofiles list -d mydb | grep "target_name"先查重
替代方案：什么时候该放弃 mongofiles，改用程序脚本
当出现以下任一情况，硬扛 mongofiles 会浪费大量调试时间：
- 需要给每个文件附加
metadata（比如{"user_id": "u123", "upload_time": ISODate(...)}） - 要跳过特定类型文件（如
*.tmp、.gitignore中列出的路径）或按大小过滤（只传 >1MB 的文件） - 上传后需立即触发后续逻辑（如写入业务表、发 MQ 消息），而不想拆成两步 shell + application
- 目标环境没有安装
mongofiles，但已有 Python/Node.js 运行时 —— PyMongo 的gridfs.GridFSBucket或mongodb.MongoClient+GridFS类几行就能搞定批量上传，且可控性高得多
真正容易被忽略的是：mongofiles 不校验上传完整性（比如网络中断后 chunk 写了一半），也不会自动重试。生产批量导入，别只盯着“能不能跑通”，得看“断了能不能续、错了好不好查”。
