架构与系统设计 / 系统课时
资源配额控制
资源配额控制
本课实现通用资源配额控制:为每个租户维护资源上限与已用量,在创建用户、门店、上传文件或调用接口前进行原子预占,成功后确认使用,失败时回滚,确保并发请求下不会突破套餐限制。
学习目标
- 建立上限、已用量和可用量的统一模型
- 掌握先预占再执行的并发控制方式
- 区分存量资源配额与周期调用量配额
配额模型
资源配额至少包含租户、资源类型、上限、已用量和统计周期。用户数、门店数、存储量属于存量型资源;接口调用量通常按日或按月重新计数,属于周期型资源。
可用量可以表示为:
当 limit 取特殊值表示不限量时,必须在模型中明确约定,例如使用 -1。不要把 0 同时解释为“不限量”和“禁止使用”,否则套餐配置很容易产生歧义。
控制链路
配额校验不能只做“先查后写”。两个并发请求都可能读到相同的剩余额度,然后同时创建资源,最终超过上限。正确做法是先通过原子操作预占额度,再执行业务操作;业务失败时释放预占。

对于数据库实现,可使用带条件的原子更新;对于高频接口调用量,可使用 Redis 原子计数并设置周期过期时间。无论使用哪种存储,都要保证“判断与增加”是一个不可分割的动作。
实现原子预占
下面的完整 Java 示例使用同步方法模拟原子预占。它展示了配额检查、占用、失败释放和最终结果;生产环境可替换为数据库条件更新或 Redis Lua 脚本。
import java.util.HashMap;
import java.util.Map;
public class ResourceQuotaDemo {
enum ResourceType {
USER,
STORE,
STORAGE_MB,
API_CALL
}
static final class QuotaExceededException extends RuntimeException {
QuotaExceededException(ResourceType type, long limit, long requested) {
super(type + " quota exceeded: limit=" + limit
+ ", requestedUsed=" + requested);
}
}
static final class QuotaService {
private final Map<ResourceType, Long> limits = new HashMap<>();
private final Map<ResourceType, Long> used = new HashMap<>();
void configure(ResourceType type, long limit, long currentUsed) {
limits.put(type, limit);
used.put(type, currentUsed);
}
synchronized void reserve(ResourceType type, long amount) {
long limit = limits.getOrDefault(type, 0L);
long current = used.getOrDefault(type, 0L);
long requested = Math.addExact(current, amount);
if (limit >= 0 && requested > limit) {
throw new QuotaExceededException(type, limit, requested);
}
used.put(type, requested);
}
synchronized void release(ResourceType type, long amount) {
long current = used.getOrDefault(type, 0L);
used.put(type, Math.max(0L, current - amount));
}
synchronized long used(ResourceType type) {
return used.getOrDefault(type, 0L);
}
}
public static void main(String[] args) {
QuotaService quota = new QuotaService();
quota.configure(ResourceType.USER, 3, 2);
quota.reserve(ResourceType.USER, 1);
System.out.println("used after reserve = " + quota.used(ResourceType.USER));
try {
quota.reserve(ResourceType.USER, 1);
} catch (QuotaExceededException ex) {
System.out.println(ex.getMessage());
}
quota.release(ResourceType.USER, 1);
System.out.println("used after release = " + quota.used(ResourceType.USER));
}
}预期输出:
used after reserve = 3
USER quota exceeded: limit=3, requestedUsed=4
used after release = 2生产环境中,用户创建成功后保留已用量;创建失败则调用释放逻辑。删除用户或门店时也要减少已用量,但应以业务数据真实删除完成为前提,避免先释放配额后删除失败造成统计偏小。
不同资源的计量方式
用户数和门店数可以直接根据有效记录计量,但每次实时统计成本较高,通常采用“计数表加定期校准”。存储量应以实际持久化后的字节数为准,上传前可按文件大小预占,上传失败或文件删除后释放。
接口调用量适合按固定窗口统计。每个周期使用独立键,例如“租户、资源类型、月份”,并设置过期时间。请求到达时先原子递增;超过上限时应回滚本次增量或通过脚本在超限时不增加。
数据一致性与降级
配额记录和业务记录位于同一数据库时,可放在一个事务中;跨数据库或使用 Redis 时,应接受短暂不一致,并通过补偿任务校准。校准依据必须来自业务事实,例如有效用户总数、门店总数或对象存储实际占用量。
套餐降级后,如果当前已用量高于新上限,不应强制删除已有资源。更稳妥的策略是允许读取和删除,但禁止继续新增,直到已用量回到限制以内,并向租户明确显示超额数量。
提示:配额控制的核心不是“报错”,而是让占用、释放、重试和补偿形成闭环。
验收检查
验收时应模拟两个并发创建请求,确认只有一个能够获得最后一个名额;再模拟业务失败,确认预占会释放。对于周期型配额,还要验证新周期开始后计数重置,旧周期键不会继续影响当前请求。
错误返回建议包含资源类型、上限和当前已用量,但不要暴露其他租户信息。客户端可据此提示升级套餐、删除闲置资源或稍后重试。
本课总结
- 配额必须通过原子预占控制,不能使用普通的先查后写
- 存量资源和周期资源计量方式不同,但可以复用统一配额接口
- 释放、补偿和降级超额策略决定配额数据能否长期保持可信
下一课预告
下一课将继续完善订阅体系,处理套餐升级、降级和到期后的权益切换,以及变更过程中的缓存与数据一致性。