Mongoose连接MongoDB首次建库时仅执行一次插入初始数据实现方法

核心实现思路：在数据库连接成功的生命周期回调中，先校验默认用户是否存在，仅当查询无结果时执行创建操作，无需引入额外依赖即可保证初始化逻辑仅执行一次。

具体实现步骤 #

1. 引入User模型 #

在mongoServer.js文件的依赖引入区域，添加User模型的导入语句，替换为你实际的模型文件存放路径：

const User = require('./user模型的实际存放路径');

2. 修改数据库连接成功回调 #

把原有mongoose.connection的open事件回调替换为带默认用户初始化逻辑的版本，你可以自行修改默认用户的名称、初始余额等配置：

mongoose.connection
.once("open", async () => {
  console.log("we are connected to the db");
  // 默认用户配置，可按需修改字段值
  const defaultUser = {
    name: "系统默认账号",
    Balance: 0,
    expenses: []
  };
  try {
    // 检查默认用户是否已存在
    const existingUser = await User.findOne({ name: defaultUser.name });
    if (!existingUser) {
      await User.create(defaultUser);
      console.log("默认账号初始化完成，该操作仅在库为空时执行一次");
    }
  } catch (err) {
    console.error("默认账号初始化异常：", err);
  }
})
.on("error", (err) => {
  console.warn(err)
})

可选优化（避免重名冲突） #

如果担心后续普通用户注册时和默认用户名重名，可以给User Schema新增一个专属的默认用户标识字段，从根本上避免判定冲突：

1. 修改userSchema定义，新增标识字段：

var userSchema = mongoose.Schema({
   name : String,
   Balance : Number,
   expenses : [ Expense.schema ],
   isDefault: { type: Boolean, default: false } // 标记是否为系统默认账号
});

2. 调整初始化逻辑的查询条件和创建数据：
   • 查询条件改为await User.findOne({ isDefault: true })
   • 创建默认用户时追加isDefault: true字段

方案说明 #

• 无额外依赖，完全基于现有技术栈实现
• 天然保证单次执行：每次服务启动连接数据库时都会先做存在性校验，只有默认账号不存在时才会写入，服务多次重启也不会生成重复数据
• 执行时机绑定数据库连接成功生命周期，不会出现数据库未就绪就执行写操作的异常

内容的提问来源于stack exchange，提问作者Yuna Ne