架构与系统设计 / 系统课时
停用冻结与恢复
停用冻结与恢复
租户生命周期不能只用“启用/禁用”两个状态表示。本课将把停用、冻结、过期、恢复和注销拆成可执行的业务规则,并给出统一校验与恢复验收方法,避免不同服务各自判断而产生权限和数据不一致。
学习目标
- 区分停用、冻结、过期、恢复和注销的业务语义
- 建立状态、访问能力与后台任务之间的行为矩阵
- 实现统一状态校验,并完成恢复后的验收检查
先定义状态语义
停用通常来自租户主动暂停使用,冻结多由风控、欠费或违规触发,过期表示订阅或合同到期。三者都可能限制访问,但触发原因、允许操作和恢复条件不同,不能合并成一个模糊的 DISABLED。
注销是不可逆流程的入口,不应被当作普通禁用状态。租户进入注销流程后,系统应先停止新增业务,再执行数据导出、保留和清理,最终才进入不可恢复状态。

建立业务行为矩阵
同一个状态需要同时约束登录、接口调用、定时任务和数据修改。建议由租户中心维护统一矩阵,网关和业务服务只消费判定结果。
| 状态 | 登录与查询 | 新增或交易 | 后台任务 | 恢复条件 |
|---|---|---|---|---|
ACTIVE |
允许 | 允许 | 正常执行 | 无 |
SUSPENDED |
允许管理员登录 | 禁止新增 | 可保留只读任务 | 租户主动恢复 |
FROZEN |
仅允许申诉入口 | 全部拒绝 | 暂停资金和通知任务 | 风控审核通过 |
EXPIRED |
允许查看账单 | 禁止新增 | 仅执行到期提醒 | 完成续费 |
CANCELLING |
仅允许导出与查看进度 | 禁止新增 | 执行导出和清理任务 | 可在保留期内撤销 |
CANCELLED |
禁止 | 禁止 | 全部停止 | 不可恢复 |
状态变更必须记录操作者、原因、来源和时间。对冻结、恢复、注销等高风险操作,还应保存审批单号或事件编号,便于审计和故障回溯。
实现统一状态校验
下面示例把访问能力封装为统一策略,避免控制器、任务和消息消费者重复编写状态判断。示例可直接使用 javac TenantStateDemo.java && java TenantStateDemo 运行。
public class TenantStateDemo {
enum TenantStatus {
ACTIVE, SUSPENDED, FROZEN, EXPIRED, CANCELLING, CANCELLED
}
static boolean canCreateBusiness(TenantStatus status) {
// 只有正常状态允许创建订单、用户或配置。
return status == TenantStatus.ACTIVE;
}
static boolean canReadData(TenantStatus status) {
// 注销完成后不再提供任何在线访问。
return status != TenantStatus.CANCELLED;
}
public static void main(String[] args) {
for (TenantStatus status : TenantStatus.values()) {
System.out.printf(
"%s create=%s read=%s%n",
status,
canCreateBusiness(status),
canReadData(status)
);
}
}
}预期输出:
ACTIVE create=true read=true
SUSPENDED create=false read=true
FROZEN create=false read=true
EXPIRED create=false read=true
CANCELLING create=false read=true
CANCELLED create=false read=false真实项目中应把策略结果缓存到网关或权限组件,但状态变更后必须立即失效缓存。关键写操作还要在业务服务内再次校验,不能只依赖网关拦截。
恢复流程与验收
恢复不是简单把状态改回 ACTIVE。系统应先验证触发原因已经解除,例如欠费已补缴、风控审批已通过或订阅已续费,再执行状态变更和资源恢复。
恢复完成后至少检查三项:登录令牌是否重新可用,租户级缓存和限流配置是否刷新,暂停的定时任务和消息消费是否按规则恢复。资金类任务应从安全检查点继续,禁止盲目重跑整个批次。
Tips:恢复接口应设计成幂等操作。重复提交同一恢复请求时,系统应返回当前状态,而不是重复触发通知、任务补偿或资源初始化。
本课总结
- 停用、冻结、过期和注销的触发原因、允许行为与恢复条件必须分别建模
- 状态判断应由统一策略提供,并在网关与核心业务服务中双重校验
- 恢复需要完成原因核验、缓存刷新、任务恢复和审计记录,而不是只修改一个字段
下一课预告
下一课将进入租户数据导出与注销流程,重点处理导出范围、数据保留期、逻辑删除和最终物理清理之间的衔接。