架构与系统设计 / 系统课时
租户配置模型
租户配置模型
本课设计一套可落地的租户配置模型,把参数、业务规则与品牌信息统一保存,并通过明确的覆盖优先级得到最终配置,避免配置散落在代码、环境变量和多张业务表中。
学习目标
- 区分平台默认配置、租户配置与临时覆盖配置
- 设计能够承载参数、规则和品牌信息的数据结构
- 使用优先级与版本号安全解析最终配置
配置模型要解决什么问题
租户配置通常不只是键值参数。它至少包含三类内容:运行参数,例如订单有效期;业务规则,例如是否允许部分退款;品牌信息,例如名称、Logo 和主题色。三类配置的校验方式与使用频率不同,但都需要统一的租户边界、版本控制和审计信息。
设计时不要为每个新参数都增加表字段。更稳妥的做法是保留稳定的公共列,把变化频繁的内容放入 JSON,并用 config_type 区分配置类型。这样既能按租户和类型查询,也能在不改表的情况下扩展配置项。
表结构与示例数据
下面的 SQL 可以直接在 MySQL 8.0 执行。tenant_id=0 表示平台默认配置,具体租户使用自己的编号。唯一键保证同一作用域、同一类型只有一份当前配置。
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;预期结果:
tenant_id | config_type | version
0 | PARAMETER | 1
1001 | BRAND | 1
1001 | BUSINESS_RULE | 1
1001 | PARAMETER | 2生产环境还应为 updated_by、变更原因和发布时间增加字段,或者把历史版本写入独立审计表。不要直接覆盖后删除旧值,否则出现错误配置时无法快速回滚。
覆盖优先级
建议采用“越具体,优先级越高”的规则:
- 请求级临时覆盖,只在当前调用链有效。
- 租户级配置,覆盖平台默认值。
- 平台默认配置,保证每个配置项都有兜底值。
- 程序内置默认值,只用于数据库尚未初始化或配置中心不可用时保底。

合并时应按从低到高的顺序执行。对象类型配置可以按字段覆盖;数组类型配置必须提前约定是整体替换、追加还是按业务键合并,不能让调用方自行猜测。对删除语义也要明确,例如用显式的 null 表示恢复默认值,而不是把空字符串同时解释为“删除”和“有效值”。
读取、缓存与版本控制
读取流程应先取得平台默认值,再读取租户配置,最后叠加请求级覆盖。数据库记录中的 version 用于缓存键、并发更新和回滚判断。更新时可以使用乐观锁:
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;预期结果:
Rows affected: 1若受影响行数为 0,说明配置已经被其他操作修改,调用方应重新读取后再提交,而不是无条件覆盖。缓存键可采用 tenant:config:<tenantId>:<configType>:<version>,发布新版本后切换版本号,再异步清理旧缓存,能够减少短暂不一致。
校验与安全边界
参数配置应校验类型、范围和必填项;业务规则应校验规则之间是否冲突;品牌信息应限制颜色格式、文本长度和资源地址来源。配置发布必须在服务端完成校验,前端表单校验只能改善体验,不能代替后端约束。
敏感信息不要与普通租户配置混存。密钥、证书和数据库凭据应进入专用密钥管理系统,配置表只保存引用标识。所有读取都必须带上当前租户上下文,禁止由客户端直接传入任意 tenant_id 后查询。
本课总结
- 稳定公共列加 JSON 内容可以兼顾查询能力与配置扩展性
- 最终配置应按内置、平台、租户、请求四级从低到高合并
- 版本号、校验、审计与敏感信息隔离是配置模型可运营的关键
下一课预告
下一课将基于这套覆盖规则,实现字典和功能开关的默认值合并、租户定制以及运行时动态生效。