如何在MongoDB(Mongoose)中规范存储应用通用配置数据？

1. 固定ID单文档模式（推荐） #

这是最常用的规范方案，通过给配置文档设置一个固定的_id（比如"app_config"），确保集合中只有一份配置文档，读写时直接通过这个固定ID操作，比findOne()更高效且语义明确。

示例代码（Mongoose） #

const mongoose = require('mongoose');

// 定义配置Schema
const AppConfigSchema = new mongoose.Schema({
  _id: { type: String, default: "app_config", required: true },
  currentGST: { type: Number, required: true }, // 存储数值（如18），而非字符串"18%"，方便计算
  minDeliveryCharge: { type: Number, required: true },
  appVersion: { type: String, required: true },
  appName: { type: String, required: true },
  appSlogan: { type: String, required: true }
});

// 添加静态方法，统一处理配置的读取与初始化
AppConfigSchema.statics.getConfig = async function() {
  let config = await this.findById("app_config");
  if (!config) {
    // 首次启动时初始化默认配置
    config = await this.create({
      _id: "app_config",
      currentGST: 18,
      minDeliveryCharge: 100,
      appVersion: "1.0.0",
      appName: "MyAwesomeApp",
      appSlogan: "Some Beautiful Slogan"
    });
  }
  return config;
};

const AppConfig = mongoose.model("AppConfig", AppConfigSchema);

读写方式 #

• 读取：直接调用静态方法await AppConfig.getConfig()，无需额外条件查询
• 更新：通过固定ID更新，确保操作的是唯一文档

await AppConfig.findByIdAndUpdate("app_config", { currentGST: 20 }, { new: true });

2. 唯一索引约束单文档模式 #

如果不想固定_id，可以添加一个专属字段（如type）并设置唯一索引，确保集合中只能存在一份配置文档。

示例代码（Mongoose） #

const AppConfigSchema = new mongoose.Schema({
  type: { type: String, default: "app_config", unique: true }, // 唯一索引约束
  currentGST: Number,
  minDeliveryCharge: Number,
  appVersion: String,
  appName: String,
  appSlogan: String
});

// 读取逻辑
async function getAppConfig() {
  let config = await AppConfig.findOne({ type: "app_config" });
  if (!config) {
    config = await AppConfig.create({
      currentGST: 18,
      minDeliveryCharge: 100,
      appVersion: "1.0.0",
      appName: "MyAwesomeApp",
      appSlogan: "Some Beautiful Slogan"
    });
  }
  return config;
}

3. 内存缓存优化 #

由于配置数据通常不会频繁修改，可以将读取到的配置缓存到内存中，减少数据库查询次数，提升性能：

let cachedConfig = null;

async function getConfig() {
  if (cachedConfig) return cachedConfig;
  cachedConfig = await AppConfig.getConfig();
  return cachedConfig;
}

// 更新配置后同步清空缓存
async function updateConfig(newData) {
  const updatedConfig = await AppConfig.findByIdAndUpdate("app_config", newData, { new: true });
  cachedConfig = updatedConfig;
  return updatedConfig;
}

关键注意事项 #

• 数据类型规范：像currentGST这类用于计算的数值，要存储数字类型（如18）而非字符串（如"18%"），显示时再转换为百分比格式，避免计算错误。
• 初始化逻辑：必须包含首次启动时的默认配置初始化，防止出现无配置可用的情况。
• 避免多文档：通过固定ID或唯一索引约束，确保集合中始终只有一份配置文档，符合单份通用数据的存储需求。

内容的提问来源于stack exchange，提问作者Rajat Kumar