架构与系统设计 / 系统课时
升级降级与到期
升级降级与到期
本课建立套餐生命周期规则:升级何时生效、降级何时执行、到期后如何进入宽限期,以及宽限结束后怎样安全回收能力,避免账单状态与实际权限不一致。
学习目标
- 区分升级、降级、到期和宽限期的生效时机
- 设计可重复执行的订阅状态转换
- 明确能力回收、数据保留与恢复规则
先定义状态与时间点
订阅至少需要记录当前套餐、待生效套餐、当前周期开始时间、周期结束时间、宽限截止时间和状态。常用状态包括生效中、宽限中、已到期和已取消。
升级通常立即生效,因为用户已经购买更高能力;降级通常在当前计费周期结束时生效,避免用户提前失去已付费权益。到期未续费时先进入宽限期,宽限结束后再回收受限能力。

状态转换必须由明确事件驱动,例如支付成功、周期结束、宽限结束或管理员取消。不要仅根据当前时间在每次请求中临时推断状态,否则同一订阅可能在不同服务中得到不同结论。
制定升级与降级规则
升级需要同时更新套餐、额度快照和账单信息。若采用按比例补差价,还要记录本次周期剩余时长和补差金额;即使计费失败,也不能先开放高阶能力。
降级只记录待生效套餐,不立即覆盖当前套餐。周期结束任务先结算旧周期,再切换套餐并生成新额度。若当前资源已超过降级后的额度,应禁止新增资源,但不要直接删除现有数据。
| 场景 | 生效时间 | 推荐处理 |
|---|---|---|
| 升级 | 支付成功后立即 | 切换套餐并刷新额度 |
| 降级 | 当前周期结束 | 保存待生效套餐,期末切换 |
| 到期未续费 | 周期结束 | 进入宽限期,限制高风险操作 |
| 宽限结束 | 宽限截止时间 | 进入已到期并回收能力 |
实现可重复的状态转换
下面的完整 Java 示例演示立即升级、预约降级、周期结束进入宽限期,以及宽限期结束后到期。每个方法先检查当前状态,使定时任务重复执行时不会重复转换。
import java.time.LocalDate;
public class SubscriptionLifecycleDemo {
enum Plan {
BASIC, PRO
}
enum Status {
ACTIVE, GRACE, EXPIRED
}
static class Subscription {
Plan currentPlan;
Plan pendingPlan;
Status status;
LocalDate periodEnd;
LocalDate graceEnd;
Subscription(Plan currentPlan, LocalDate periodEnd) {
this.currentPlan = currentPlan;
this.periodEnd = periodEnd;
this.status = Status.ACTIVE;
}
void upgrade(Plan targetPlan) {
if (status != Status.ACTIVE) {
throw new IllegalStateException("inactive subscription");
}
currentPlan = targetPlan;
pendingPlan = null;
}
void scheduleDowngrade(Plan targetPlan) {
if (status != Status.ACTIVE) {
throw new IllegalStateException("inactive subscription");
}
pendingPlan = targetPlan;
}
void onPeriodEnd(LocalDate today) {
if (status != Status.ACTIVE || today.isBefore(periodEnd)) {
return;
}
// 先应用已预约的降级,再进入宽限期等待续费
if (pendingPlan != null) {
currentPlan = pendingPlan;
pendingPlan = null;
}
status = Status.GRACE;
graceEnd = periodEnd.plusDays(7);
}
void onGraceEnd(LocalDate today) {
if (status == Status.GRACE && !today.isBefore(graceEnd)) {
status = Status.EXPIRED;
}
}
}
public static void main(String[] args) {
Subscription subscription =
new Subscription(Plan.BASIC, LocalDate.of(2026, 8, 31));
subscription.upgrade(Plan.PRO);
subscription.scheduleDowngrade(Plan.BASIC);
subscription.onPeriodEnd(LocalDate.of(2026, 8, 31));
subscription.onPeriodEnd(LocalDate.of(2026, 8, 31));
subscription.onGraceEnd(LocalDate.of(2026, 9, 7));
System.out.println(subscription.currentPlan);
System.out.println(subscription.status);
}
}预期输出:
BASIC
EXPIRED示例中的日期是固定演示值。生产环境应使用数据库事务锁定订阅记录,并通过事件表或消息队列通知权限、配额和计费服务;事件必须携带订阅版本号,消费者只处理比本地版本更新的事件。
设计到期后的能力回收
进入宽限期后,可以保留登录、查看和导出能力,同时限制创建、扩容或高成本操作。进入已到期状态后,再关闭核心写操作和外部调用,但仍应保留数据一段明确时间。
能力回收应采用“拒绝新增、保留已有、允许恢复”的原则。用户续费后,系统恢复套餐和额度即可,不应依赖人工重新创建资源。需要永久删除数据时,必须由独立的数据保留策略执行,不能把套餐到期直接等同于删除。
Tips:权限判断应读取统一的订阅能力快照,而不是由各业务服务分别解释套餐名称。
保证账单与权限一致
升级、续费等操作应以支付成功事件作为最终生效依据。若支付回调重复到达,系统必须根据业务订单号和订阅版本保证幂等;若权限刷新失败,则通过重试或补偿任务继续同步。
验收时要覆盖立即升级、预约降级、降级前取消、到期进入宽限、宽限内续费、宽限结束、重复任务执行和资源超额八类场景。动态订单号、时间和事件 ID 可使用 <ID>、<TIME> 表示,实际值可能不同。
本课总结
- 升级通常支付成功后立即生效,降级通常在当前周期结束时生效
- 到期应先进入宽限期,再按明确策略回收能力并保留可恢复的数据
- 状态转换、账单更新和能力刷新都必须支持幂等与补偿
下一课预告
下一课将把套餐生命周期与租户侧的功能开关、资源校验和运营管理流程连接起来,完成订阅能力的统一落地。