必须手动创建 migrate-mongo-config.js 文件于项目根目录配置完整 MongoDB 连接 URL含 authSource、replicaSet 等参数指定 databaseName 存放迁移元数据并确保 Node.js ≥14.18。怎么初始化 migrate-mongo 配置并连接到真实 MongoDB 实例必须先有 migrate-mongo-config.js否则所有命令都报错 Cannot find config file。这个文件不是自动生成的得手动写而且路径必须在项目根目录或用 -f 显式指定。常见错误是把 MongoDB 连接字符串写成本地 mongodb://localhost:27017但实际环境用了副本集或带认证的集群——这时要确保 url 字段包含完整参数比如 mongodb://user:passhost:27017/db?authSourceadminreplicaSetrs0。漏掉 authSource 或 replicaSet 会导致连接成功但迁移失败错误信息往往是模糊的 Topology is closed 或 NotMaster。配置里 databaseName 是迁移元数据migrations 集合存放的数据库不一定是业务库建议单独用 migrate-mongo 库避免污染业务数据mongoclient 选项从 v9 开始已弃用改用 url options如 { useNewUrlParser: true, useUnifiedTopology: true }Node.js 版本需 ≥14.18低版本会因 fs.promises.rm 报错如何创建和运行一次带副作用的迁移脚本比如改 schema 或重算字段迁移脚本本质是两个函数up 和 down都接收 db 实例MongoDB Node Driver 的 Db 对象。别直接调 db.collection(xxx).updateMany() 就完事——没加 await 会导致迁移标记写入成功但实际操作没跑完。典型场景给用户集合加默认头像字段。容易踩的坑是没处理空值、没加索引、或者在 up 里用了不支持的语法比如 $setOnInsert 在旧版 MongoDB 不可用。up 必须返回 Promise推荐用 async/await 写法避免回调地狱批量更新务必加 { multi: true }v3.x 驱动或用 updateMany()v4否则只改第一条down 不是简单删字段要考虑数据一致性如果 up 添加了唯一索引down 必须先删索引再删字段否则 dropIndex 会失败测试时用 migrate-mongo up --file xxx.js 单跑一个脚本比全量 up 更安全module.exports { async up(db) { await db.collection(users).updateMany( { avatar: null }, { $set: { avatar: /default.png } } ); await db.collection(users).createIndex({ email: 1 }, { unique: true }); }, async down(db) { await db.collection(users).dropIndex({ email: 1 }); await db.collection(users).updateMany( { avatar: /default.png }, { $unset: { avatar: } } ); }};为什么 migrate-mongo 的状态记录有时不准怎么修复迁移卡住的问题它靠 migrations 集合默认在配置的 databaseName 下记已执行脚本名和时间戳。一旦网络中断、进程被杀、或脚本抛未捕获异常就可能出现「脚本实际没跑完但记录已写入」的情况——下次 up 直接跳过导致数据不一致。 通义听悟 阿里云通义听悟是聚焦音视频内容的工作学习AI助手依托大模型帮助用户记录、整理和分析音视频内容体验用大模型做音视频笔记、整理会议记录。