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

资源配额控制

资源配额控制

本课实现通用资源配额控制:为每个租户维护资源上限与已用量,在创建用户、门店、上传文件或调用接口前进行原子预占,成功后确认使用,失败时回滚,确保并发请求下不会突破套餐限制。

学习目标

  • 建立上限、已用量和可用量的统一模型
  • 掌握先预占再执行的并发控制方式
  • 区分存量资源配额与周期调用量配额

配额模型

资源配额至少包含租户、资源类型、上限、已用量和统计周期。用户数、门店数、存储量属于存量型资源;接口调用量通常按日或按月重新计数,属于周期型资源。

可用量可以表示为:

available=limit−usedavailable = limit - used

当 limit 取特殊值表示不限量时,必须在模型中明确约定,例如使用 -1。不要把 0 同时解释为“不限量”和“禁止使用”,否则套餐配置很容易产生歧义。

控制链路

配额校验不能只做“先查后写”。两个并发请求都可能读到相同的剩余额度,然后同时创建资源,最终超过上限。正确做法是先通过原子操作预占额度,再执行业务操作;业务失败时释放预占。

资源配额预占与回滚流程

对于数据库实现,可使用带条件的原子更新;对于高频接口调用量,可使用 Redis 原子计数并设置周期过期时间。无论使用哪种存储,都要保证“判断与增加”是一个不可分割的动作。

实现原子预占

下面的完整 Java 示例使用同步方法模拟原子预占。它展示了配额检查、占用、失败释放和最终结果;生产环境可替换为数据库条件更新或 Redis Lua 脚本。

java
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));
    }
}

预期输出:

text
used after reserve = 3
USER quota exceeded: limit=3, requestedUsed=4
used after release = 2

生产环境中,用户创建成功后保留已用量;创建失败则调用释放逻辑。删除用户或门店时也要减少已用量,但应以业务数据真实删除完成为前提,避免先释放配额后删除失败造成统计偏小。

不同资源的计量方式

用户数和门店数可以直接根据有效记录计量,但每次实时统计成本较高,通常采用“计数表加定期校准”。存储量应以实际持久化后的字节数为准,上传前可按文件大小预占,上传失败或文件删除后释放。

接口调用量适合按固定窗口统计。每个周期使用独立键,例如“租户、资源类型、月份”,并设置过期时间。请求到达时先原子递增;超过上限时应回滚本次增量或通过脚本在超限时不增加。

数据一致性与降级

配额记录和业务记录位于同一数据库时,可放在一个事务中;跨数据库或使用 Redis 时,应接受短暂不一致,并通过补偿任务校准。校准依据必须来自业务事实,例如有效用户总数、门店总数或对象存储实际占用量。

套餐降级后,如果当前已用量高于新上限,不应强制删除已有资源。更稳妥的策略是允许读取和删除,但禁止继续新增,直到已用量回到限制以内,并向租户明确显示超额数量。

提示:配额控制的核心不是“报错”,而是让占用、释放、重试和补偿形成闭环。

验收检查

验收时应模拟两个并发创建请求,确认只有一个能够获得最后一个名额;再模拟业务失败,确认预占会释放。对于周期型配额,还要验证新周期开始后计数重置,旧周期键不会继续影响当前请求。

错误返回建议包含资源类型、上限和当前已用量,但不要暴露其他租户信息。客户端可据此提示升级套餐、删除闲置资源或稍后重试。

本课总结

  • 配额必须通过原子预占控制,不能使用普通的先查后写
  • 存量资源和周期资源计量方式不同,但可以复用统一配额接口
  • 释放、补偿和降级超额策略决定配额数据能否长期保持可信

下一课预告

下一课将继续完善订阅体系,处理套餐升级、降级和到期后的权益切换,以及变更过程中的缓存与数据一致性。

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

目录与阅读设置

阅读设置

17

记录一个想法

资源配额控制

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

登录哪都通