Mongoose枚举最佳实践疑问：TS枚举键值与数据库存储适配

针对你提出的三个问题，直接给出结论和解决方案：

1. Mongoose Schema中使用枚举KEY而非VALUE是否合理？ #

完全合理。核心原因包括：

• 存储与查询效率更高：KEY（如USD）是短标识，相比长翻译文本占用更少存储空间，索引查询速度更快。
• 数据稳定性更强：翻译文本可能因多语言需求、文案调整发生变化，而KEY作为业务标识固定不变，不会因展示层修改导致数据库数据变更。
• 业务逻辑更清晰：KEY是业务侧统一的标准标识，避免因翻译文本歧义引发逻辑错误。

2. 以KEY为数据库存储标识、VALUE为翻译的设计思路是否可行？ #

这是非常推荐的工业级实践方案，广泛应用于多语言、国际化场景：

• 实现了业务逻辑与展示层的解耦：存储层仅保存稳定的业务标识，展示层根据需求映射为对应语言的文本。
• 便于后续扩展：新增语言或修改翻译时，只需维护翻译映射表，无需修改数据库结构或已有数据。
• 避免数据冗余：相同标识的翻译只需维护一次，不会在数据库中重复存储长文本。

3. 如何优化创建文档的体验？ #

当前问题的核心是TS枚举定义与Mongoose枚举约束不匹配：你定义的枚举是KEY => 翻译文本，但Mongoose要求存储KEY，直接用ECurrency.USD会传入翻译文本触发报错。以下是三种优化方案：

方案一：调整枚举定义，分离标识与翻译 #

重新定义纯业务标识枚举，单独维护翻译映射表，从根源上匹配Mongoose约束：

// 业务标识枚举（与数据库存储值完全一致）
enum ECurrencyCode {
  USD = 'USD',
  EUR = 'EUR'
}

// 翻译映射表（可根据多语言需求拆分独立文件）
const CurrencyTranslations = {
  [ECurrencyCode.USD]: 'United States dollar',
  [ECurrencyCode.EUR]: 'Euro'
}

// Mongoose Schema配置
const schema = new mongoose.Schema({
  currency: {
    type: String,
    enum: Object.values(ECurrencyCode), // 直接使用枚举值，与存储逻辑一致
    required: true
  }
})

使用方式：

• 创建文档：currency: ECurrencyCode.USD（直接传入标识，完全符合Schema约束）
• 获取翻译文本：CurrencyTranslations[document.currency]

方案二：利用Mongoose虚拟属性自动映射翻译 #

在Schema中添加虚拟属性，查询文档时自动返回翻译文本，无需手动处理：

// 沿用你原有的枚举定义
enum ECurrency {
  USD = 'United States dollar',
  EUR = 'Euro'
}

// 反向映射：从翻译文本获取KEY（用于Schema验证和存储）
const CurrencyKeyMap = Object.fromEntries(
  Object.entries(ECurrency).map(([key, value]) => [value, key])
)

const schema = new mongoose.Schema({
  currency: {
    type: String,
    enum: Object.keys(ECurrency),
    required: true
  }
})

// 添加虚拟属性，自动返回翻译文本
schema.virtual('currencyLabel').get(function() {
  return ECurrency[this.currency as keyof typeof ECurrency]
})

// 查询时需指定返回虚拟属性：
// Model.find().select('+currencyLabel')

使用方式：

• 创建文档：封装工具函数自动转换枚举值为KEY

  function getCurrencyKey(value: ECurrency) {
    return CurrencyKeyMap[value]
  }
  // 调用示例：currency: getCurrencyKey(ECurrency.USD)
  

• 查询文档：直接通过document.currencyLabel获取翻译文本

方案三：自定义Mongoose验证器（兼容原有枚举） #

如果不想修改原有枚举定义，可添加自定义验证器，允许传入枚举VALUE并自动转换为KEY存储：

enum ECurrency {
  USD = 'United States dollar',
  EUR = 'Euro'
}

const CurrencyKeyMap = Object.fromEntries(
  Object.entries(ECurrency).map(([key, value]) => [value, key])
)

const schema = new mongoose.Schema({
  currency: {
    type: String,
    enum: Object.keys(ECurrency),
    required: true,
    validate: {
      validator: function(v: string) {
        // 允许传入KEY或VALUE，自动转换为KEY存储
        if (Object.values(ECurrency).includes(v as ECurrency)) {
          this.currency = CurrencyKeyMap[v as ECurrency]
          return true
        }
        return Object.keys(ECurrency).includes(v)
      },
      message: props => `${props.value} is not a valid currency`
    }
  }
})

使用方式：创建文档时可直接传入ECurrency.USD，验证器会自动转换为USD存储，无需手动处理。

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