架构与系统设计 / 系统课时

租户配置模型

租户配置模型

本课设计一套可落地的租户配置模型,把参数、业务规则与品牌信息统一保存,并通过明确的覆盖优先级得到最终配置,避免配置散落在代码、环境变量和多张业务表中。

学习目标

  • 区分平台默认配置、租户配置与临时覆盖配置
  • 设计能够承载参数、规则和品牌信息的数据结构
  • 使用优先级与版本号安全解析最终配置

配置模型要解决什么问题

租户配置通常不只是键值参数。它至少包含三类内容:运行参数,例如订单有效期;业务规则,例如是否允许部分退款;品牌信息,例如名称、Logo 和主题色。三类配置的校验方式与使用频率不同,但都需要统一的租户边界、版本控制和审计信息。

设计时不要为每个新参数都增加表字段。更稳妥的做法是保留稳定的公共列,把变化频繁的内容放入 JSON,并用 config_type 区分配置类型。这样既能按租户和类型查询,也能在不改表的情况下扩展配置项。

表结构与示例数据

下面的 SQL 可以直接在 MySQL 8.0 执行。tenant_id=0 表示平台默认配置,具体租户使用自己的编号。唯一键保证同一作用域、同一类型只有一份当前配置。

sql
CREATE TABLE tenant_config (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    tenant_id BIGINT NOT NULL,
    config_type VARCHAR(32) NOT NULL,
    config_value JSON NOT NULL,
    version INT NOT NULL DEFAULT 1,
    enabled TINYINT NOT NULL DEFAULT 1,
    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
        ON UPDATE CURRENT_TIMESTAMP,
    UNIQUE KEY uk_tenant_type (tenant_id, config_type)
);

INSERT INTO tenant_config
    (tenant_id, config_type, config_value, version)
VALUES
    (0, 'PARAMETER',
     JSON_OBJECT('orderExpireMinutes', 30, 'currency', 'CNY'), 1),
    (1001, 'PARAMETER',
     JSON_OBJECT('orderExpireMinutes', 15), 2),
    (1001, 'BUSINESS_RULE',
     JSON_OBJECT('partialRefundEnabled', true), 1),
    (1001, 'BRAND',
     JSON_OBJECT('name', '星云商户', 'primaryColor', '#246BFD'), 1);

SELECT tenant_id, config_type, version
FROM tenant_config
WHERE tenant_id IN (0, 1001)
ORDER BY tenant_id, config_type;

预期结果:

text
tenant_id | config_type   | version
0         | PARAMETER     | 1
1001      | BRAND         | 1
1001      | BUSINESS_RULE | 1
1001      | PARAMETER     | 2

生产环境还应为 updated_by、变更原因和发布时间增加字段,或者把历史版本写入独立审计表。不要直接覆盖后删除旧值,否则出现错误配置时无法快速回滚。

覆盖优先级

建议采用“越具体,优先级越高”的规则:

  1. 请求级临时覆盖,只在当前调用链有效。
  2. 租户级配置,覆盖平台默认值。
  3. 平台默认配置,保证每个配置项都有兜底值。
  4. 程序内置默认值,只用于数据库尚未初始化或配置中心不可用时保底。

租户配置四级覆盖关系

合并时应按从低到高的顺序执行。对象类型配置可以按字段覆盖;数组类型配置必须提前约定是整体替换、追加还是按业务键合并,不能让调用方自行猜测。对删除语义也要明确,例如用显式的 null 表示恢复默认值,而不是把空字符串同时解释为“删除”和“有效值”。

读取、缓存与版本控制

读取流程应先取得平台默认值,再读取租户配置,最后叠加请求级覆盖。数据库记录中的 version 用于缓存键、并发更新和回滚判断。更新时可以使用乐观锁:

sql
UPDATE tenant_config
SET config_value = JSON_SET(config_value, '$.orderExpireMinutes', 20),
    version = version + 1
WHERE tenant_id = 1001
  AND config_type = 'PARAMETER'
  AND version = 2;

预期结果:

text
Rows affected: 1

若受影响行数为 0,说明配置已经被其他操作修改,调用方应重新读取后再提交,而不是无条件覆盖。缓存键可采用 tenant:config:<tenantId>:<configType>:<version>,发布新版本后切换版本号,再异步清理旧缓存,能够减少短暂不一致。

校验与安全边界

参数配置应校验类型、范围和必填项;业务规则应校验规则之间是否冲突;品牌信息应限制颜色格式、文本长度和资源地址来源。配置发布必须在服务端完成校验,前端表单校验只能改善体验,不能代替后端约束。

敏感信息不要与普通租户配置混存。密钥、证书和数据库凭据应进入专用密钥管理系统,配置表只保存引用标识。所有读取都必须带上当前租户上下文,禁止由客户端直接传入任意 tenant_id 后查询。

本课总结

  • 稳定公共列加 JSON 内容可以兼顾查询能力与配置扩展性
  • 最终配置应按内置、平台、租户、请求四级从低到高合并
  • 版本号、校验、审计与敏感信息隔离是配置模型可运营的关键

下一课预告

下一课将基于这套覆盖规则,实现字典和功能开关的默认值合并、租户定制以及运行时动态生效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

租户配置模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通