如何保证数据库 lookup table 与前端代码的配置一致性

解决方案 #

核心思路是以代码中的配置作为唯一可信源，反向同步数据库，彻底避免双向维护，具体落地可以按以下步骤执行：

• 第一步：抽离全局唯一的分类配置文件
  把你现有的categoryLabelsAndOrder抽成独立的公共常量文件，前后端可共同引用，如有需要可以额外加ID字段和数据库主键对应：

// shared/constants/productCategories.ts
export const PRODUCT_CATEGORIES = {
  OIL_CLEANSER: { id: 1, label: "Oil cleanser", sortKey: 1 },
  CLEANSER: { id: 2, label: "Cleanser", sortKey: 2 },
  TONER: { id: 3, label: "Toner", sortKey: 3 },
  // 其余分类
} as const;

// 导出TS类型，做静态校验
export type ProductCategoryKey = keyof typeof PRODUCT_CATEGORIES;

所有UI用到的label、排序、甚至后续要加的分类图标、提示文案等UI专属字段，全部存在这个配置里，不需要入库。

• 第二步：数据库seed、迁移全从配置读取
  你的categories表只需要存id、key（对应配置的键名，比如OIL_CLEANSER）两个核心字段即可，seed脚本直接遍历这个配置对象生成插入语句，完全不需要手写分类数据。
  如果要做分类合并/删除这类调整，只需要先改配置文件，再写对应的数据迁移脚本：把旧分类关联的产品数据迁移到新分类，再删除数据库里的旧分类记录即可，全程不需要改其他业务代码。

• 第三步：低成本做一致性校验
  不需要每次查询lookup表都做校验，只需要在两个节点做校验即可：

1. 服务启动时执行一次预校验：读取数据库categories表的数据和本地配置对比，存在不一致直接抛出异常终止启动，从源头避免不同步的代码上线
2. CI/CD流程里加校验脚本：只要配置和数据库表结构/数据不匹配，直接阻断代码合并，提前发现问题

方案优势 #

1. 完全实现单数据源，所有分类相关的变更只需要改配置文件+对应迁移脚本，不会出现两边不同步的问题
2. UI配置和数据库存储完全解耦，UI专属字段不需要入库，符合分层设计
3. 配合TS类型可以做静态校验，业务代码里传错分类键值直接在编译期报错，比数据库enum更灵活，调整成本更低
4. 如果是前后端分离项目，可以把配置文件封装成内部公共包/monorepo公共模块，前后端依赖同一个版本，保证全端同步。

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