概述
用户冻结解冻是管理员在后台对违规用户施加的惩罚措施:临时或永久地禁止其登录、评论、发动态。这里从产品语义、跨系统联动方案与存储选型讲起,再拆到具体落地,管理端一按键,C 端怎么知道这个用户被冻结了,以及冻结状态写到哪里、在哪些业务入口拦、解冻怎么做到即时生效。
纲要
- 业务场景与产品语义:冻结是风控的最后手段,临时性、范围化、管理员操作
- 跨系统联动方案对比:业务入口校验 / Token 拦截器 / 网关黑名单
- 接口设计:
POST /manage/users/freeze、POST /manage/users/unfreeze - 冻结状态存哪里:Redis 还是 MySQL,key 与 value 设计,TTL 取舍
- C 端校验位置:登录链路校验,Token 拦截器扩展,后台列表状态回显
- 解冻流程:删 key 即生效
- 实现步骤拆解与全链路时序图
- 异常与边界,Redis 丢失要不要 MySQL 兜底
- 验证要点与常见误解
业务场景与产品语义
内容型产品绕不开一个问题:总有人发不当言论、违法违规内容,或者被其他用户举报。人工审核、内容删除都是「收拾现场」,冻结用户才是让麻烦制造者直接下场的手段,它是风控体系里粒度最重、也最有效的一招。
在交友项目的管理后台里,冻结的入口藏在用户管理:从用户列表点进某个用户的详情,能看到当前状态是「正常」。一旦这个用户被举报、或审核系统检出问题内容,管理员就可以对他发起冻结。
原始素材里对需求的口语化描述,整理成结构化的产品语义就是三件事:
| 属性 | 说明 | 页面表现 |
|---|---|---|
| 临时性 | 冻结不是拉黑封号,随时可以解冻恢复 | 详情页按钮在「冻结/解冻」间切换 |
| 冻结时间 | 3 天、7 天(临时),或永久冻结 | 冻结表单的单选项 |
| 冻结范围 | 登录、发言(评论)、发布动态,可组合限制 | 冻结表单的多选项 |
| 原因与备注 | 记录冻结依据,方便追溯与申诉处理 | 冻结表单的文本域 |
解冻则简单得多:只需要填写备注说明原因即可。
管理端的交互大致是下面两个界面。
用户详情页(正常状态):
+--------------------------------------------------+
| 用户管理 > 用户详情 [返回] |
+--------------------------------------------------+
| 头像 昵称:邻家的猫 |
| 手机号:138****1234 |
| 用户状态:● 正常 |
+--------------------------------------------------+
| 基本信息 |
| 性别:女 年龄:24 所在地:上海 |
+--------------------------------------------------+
| [冻结] |
+--------------------------------------------------+
要点:
- 用户状态字段展示「正常」或「已冻结」,是管理员决定是否操作的依据;
- [冻结] 按钮点击后弹出冻结表单;
- 状态为「已冻结」时,此按钮位置切换为 [解冻]。
冻结表单(弹层):
+--------------------------------------------------+
| 冻结用户 [X] |
+--------------------------------------------------+
| 冻结时间: |
| ( ) 3天 ( ) 7天 ( ) 永久冻结 |
| |
| 冻结范围: |
| [x] 登录 [ ] 发言 [ ] 发布动态 |
| |
| 冻结原因: |
| +--------------------------------------------+ |
| | 发布违法违规内容 | |
| +--------------------------------------------+ |
| |
| 备注: |
| +--------------------------------------------+ |
| | | |
| +--------------------------------------------+ |
| |
| [取消] [确认冻结] |
+--------------------------------------------------+
要点:
- 冻结时间为单选:3 天 / 7 天 / 永久;
- 冻结范围为多选:登录、发言、发布动态,冻结「发布动态」即在规定时间内禁止发动态;
- 冻结原因与备注用于留痕,是后续解冻和申诉的依据;
- 确认后请求发往管理端,详情页刷新后按钮变为「解冻」。
跨系统联动:C 端怎么感知冻结
这个功能有个容易忽视的架构特点:操作方和受限方不在同一个系统里。管理员在 mf-admin(管理后台)点击冻结,而被限制登录、发动态的是 mf-app-server(C 端服务)的用户。中间必须有一条通路,让 C 端在处理用户请求时能感知到「这个用户被冻结了」。
候选方案有三条路:
| 方案 | 做法 | 覆盖范围 | 实时性 | 实现复杂度 |
|---|---|---|---|---|
| A. 业务入口校验 | 登录、评论、发动态等接口执行前,查一次冻结状态 | 只覆盖接入了校验的接口 | 高(每次请求实时查) | 低,加一个校验方法逐接口接入 |
| B. Token 拦截器校验 | TokenInterceptor 里统一查冻结状态 | 覆盖所有需要登录的接口 | 高 | 低,但会拖累全部请求 |
| C. Redis 黑名单 + 网关 | 冻结名单写 Redis,网关层统一拦截 | 覆盖经由网关的全部请求 | 高 | 中,需要网关配合,呼应网关鉴权的思路 |
三条路都能达到目的,取舍点在覆盖面和请求开销之间。
项目工程的选择是方案 A。实读 10-数据统计与内容审核/01-代码 工程,结论如下:
mf-app-server的TokenInterceptor中没有任何冻结相关逻辑,方案 B 没有被采用;- 冻结校验封装在
UserFreezeService.checkUserStatus(state, userId)里,在业务入口处按需调用; - 目前唯一的调用点是登录流程的第一步
UserService.sendMsg():发短信验证码前,先根据手机号查用户,用户存在则校验冻结范围「1」(登录)。被冻结的用户连验证码都收不到,登录自然被拒; - 发布动态、发布评论接口的校验,配套资料明确说「需要做相应的校验工作」,也就是同样的方法逐个接入,属于同一个模式的复制。
选 A 而不是 B 的理由值得体会:冻结要拦的是「产生新内容」和「重新登录」这类动作,浏览、翻看他人动态这类读操作并不在惩罚范围内。如果放进拦截器,等于全站请求都要多查一次 Redis,而其中大部分是读请求,白白增加了延迟和 Redis 压力。按业务入口逐个校验,粒度刚好能对上「冻结范围」这个产品概念,冻结「发言」不影响「登录」,冻结「登录」则全部受限。
方案 C 更适合微服务数量多、入口分散的场景,网关层统一拦截可以避免每个服务都写一遍校验。项目目前 C 端入口集中,方案 A 已经够用。
接口设计
管理端两个接口,挂在 ManagerController 下,路径前缀 /manage:
| 接口 | 方法 | 路径 | 请求参数 | 响应 |
|---|---|---|---|---|
| 用户冻结 | POST | /manage/users/freeze | userId、freezingTime、freezingRange、冻结原因、备注 | Map(message) |
| 用户解冻 | POST | /manage/users/unfreeze | userId、解冻原因 | Map(message) |
参数里有两个枚举值值得留意:
freezingTime(冻结时长):1冻结 3 天,2冻结 7 天,3永久冻结freezingRange(冻结范围):1冻结登录,2冻结发言(发评论),3冻结发布动态
配套资料里把这两个路径念成了「manmanageruserdown当freezing」和「manager杠users杠onpzon」,按工程实读修正为 /manage/users/freeze 与 /manage/users/unfreeze;「死于类型的 message」实为 Map 类型的 message。
冻结请求示例:
POST /manage/users/freeze
{
"userId": "106",
"freezingTime": "1",
"freezingRange": "1",
"reason": "发布违法违规内容",
"remarks": "用户多次发布违规评论"
}
冻结响应:
{
"message": "冻结成功"
}
解冻请求示例:
POST /manage/users/unfreeze
{
"userId": "106",
"remarks": "用户已删除违规内容,申诉通过"
}
设计上有两点值得注意。其一,接口参数里只有目标 userId,没有操作人字段,操作人来自管理端登录态(管理端同样走 token 认证,由 AdminHolder 之类的上下文持有当前管理员),不该由前端传,防止伪造。其二,冻结接口的 freezingTime 用数字枚举而不是直接传天数,把「3 天/7 天/永久」的语义收敛在后端,前端不用理解 TTL 换算细节。
服务层实现的核心逻辑一句话就能说完:冻结 = 写 Redis 带 TTL,解冻 = 删 key。
// mf-admin:ManagerService(节选,单位应为 DAYS,见下文分析)
public Map userFreeze(Map params) {
String userId = params.get("userId").toString();
String key = Constants.USER_FREEZE + userId;
Integer freezingTime = Integer.valueOf(params.get("freezingTime").toString());
int days = 0;
if (freezingTime == 1) {
days = 3;
} else if (freezingTime == 2) {
days = 7;
}
// value 存参数整包 JSON,C 端校验时按 freezingRange 比对
String value = JSON.toJSONString(params);
if (days > 0) {
redisTemplate.opsForValue().set(key, value, days, TimeUnit.DAYS);
} else {
redisTemplate.opsForValue().set(key, value); // 永久冻结不设 TTL
}
Map retMap = new HashMap();
retMap.put("message", "冻结成功");
return retMap;
}
public Map userUnfreeze(Map params) {
String userId = params.get("userId").toString();
String key = Constants.USER_FREEZE + userId;
redisTemplate.delete(key);
Map retMap = new HashMap();
retMap.put("message", "解冻成功");
return retMap;
}
C 端侧的感知入口是 mf-app-server 里新加的 UserFreezeService,提供统一校验方法:
// mf-app-server:UserFreezeService
public void checkUserStatus(String state, Long userId) {
// 1、拼 key,查 Redis
String key = Constants.USER_FREEZE + userId;
String value = redisTemplate.opsForValue().get(key);
// 2、冻结记录存在,且冻结范围与本次操作一致,则拦截
if (!StringUtils.isEmpty(value)) {
Map map = JSON.parseObject(value, Map.class);
String freezingRange = (String) map.get("freezingRange");
if (state.equals(freezingRange)) {
throw new BusinessException(ErrorResult.builder().errMessage("用户被冻结").build());
}
}
}
登录入口的接入方式:
// UserService.sendMsg:发验证码前先拦冻结
public void sendMsg(String phone) {
// 根据手机号查用户,存在则校验冻结范围 "1"(登录)
User user = userApi.findByMobile(phone);
if (user != null) {
userFreezeService.checkUserStatus("1", user.getId());
}
// ...后续生成验证码、存 Redis、发短信
}
范围约定上,"1" 对应登录,被冻结登录的用户在发验证码这一步就被拒绝,提示「用户被冻结」。评论、发动态对应其他范围值,在各自接口接入同一个方法即可。
管理端的用户详情查询也和冻结状态联动了:UserInfo 实体上加了一个非表字段 userStatus(标注 @TableField(exist = false),默认 "1"),findUserById 查详情时顺带查一下 Redis,key 存在就置为 "2"(已冻结)。这从侧面再次印证了冻结状态不落 tb_user / tb_user_info 表,表结构没动,状态完全由 Redis 承载。
冻结状态存哪里:Redis 还是 MySQL
冻结数据要有地方放。需求分析篇已经比过三种方案,这里从实现角度补一个关键理由:冻结校验发生在 C 端的高频链路上。登录、发评论、发动态,每一次请求都可能要查一次冻结状态:
- 放 MySQL:每条请求多一次 DB 查询,还得给表加索引、管连接池,收益却是「管理员偶尔才冻结一个人」这种低频写
- 放 Redis:
GET一个 key,O(1),单机 Redis 轻松扛几万 QPS,对既有链路的延迟影响可以忽略
而管理端的写操作(冻结/解冻)一天没几次,Redis 完全兜得住。读写频率的巨大反差,决定了状态放 Redis。
两条路的整体对比:
| 维度 | MySQL | Redis |
|---|---|---|
| 持久性 | 强,重启不丢 | 弱,故障或内存淘汰可能丢数据 |
| 临时冻结的到期处理 | 需要定时任务扫描过期记录再解冻 | 设置 TTL,到期自动删除,天然解冻 |
| 查询延迟 | 毫秒级,走数据库连接 | 亚毫秒级 |
| 实现成本 | 高:引入定时任务(当时配套工程尚未讲到) | 低:一行 set 带上过期时间 |
决定性因素是「临时冻结」这个需求本身。冻结 3 天,3 天后要自动恢复,用 MySQL 就得回答「谁来执行解冻」,答案是定时任务周期性扫描,而配套工程进行到这里还没有引入定时任务。Redis 的 TTL 则把这个问题消解了:冻结三天就给 key 设三天的存活时间,时间一到 key 自动消失,「没有冻结数据」和「已解冻」在查询侧完全等价。
工程的选型是 Redis,落地的数据结构如下(实读 Constants.java 与 ManagerService):
- key:
USER_FREEZE_ + userId,常量定义在mf-commons的Constants中,值为"USER_FREEZE_"; - value:冻结请求参数整包序列化的 JSON,包含
userId、freezingTime(1=3 天,2=7 天,3=永久)、freezingRange(冻结范围)、remarks等字段。不只是一个布尔标记,C 端校验时需要从中取出freezingRange和传入的「本次操作所属范围」比对,才能实现「冻结发言但没冻结登录」这类精细化限制。
工程实读(mf-commons/src/main/java/com/mf/commons/utils/Constants.java:14):
public static final String USER_FREEZE = "USER_FREEZE_";
key 的完整形态是 USER_FREEZE_{userId},比如 USER_FREEZE_106。设计意图很直白:
- 前缀隔离:Redis 里这个项目已经堆了
CHECK_CODE_(验证码)等一堆 key,统一前缀方便肉眼排查和批量清理 - userId 收尾:查某个用户的冻结状态就是一次精确
GET,不需要 scan、不需要二级索引
value 存的不是简单的「1/2」标记,而是把管理端提交的整个参数 Map 序列化成 JSON(ManagerService.userFreeze 里 JSON.toJSONString(params)),实际内容类似:
{
"userId": "106",
"freezingTime": "1",
"freezingRange": "1",
"reason": "发布不当言论",
"remarks": "多次违规"
}
这样设计的好处在校验端立刻体现:C 端拿到这个 JSON 就能判断冻结的是哪个范围,只冻结了发言(freezingRange=2)的用户,登录不该被拦。如果 value 只存一个「已冻结」,就没法做范围级别的精细化控制了。
不过要泼一盆冷水:Redis 在这里承担的是「状态标记」的角色,而不是事实源。冻结作为一次管理操作,其操作记录(谁冻的、为什么冻、冻多久)理应完整落在数据库里留痕,这在前面反复出现过:Redis 里的标记是缓存性质的,事实源在库。纯 Redis 方案的隐患很直接:Redis 挂了或数据被淘汰,冻结状态凭空消失,违规用户「自动越狱」。教学工程为了聚焦 TTL 的巧妙用法省略了落库步骤,生产实现应该「MySQL 记操作流水 + Redis 存生效状态」双写,Redis 丢失时还能从流水重建。
TTL 的取舍分情况,这是最容易想错的一个点。冻结是管理员主动解除的操作,直觉上「不该自动过期」,但产品需求里明确有「冻结 3 天 / 7 天」这种定期惩罚,过期解封本来就是需求的一部分。所以:
| freezingTime | 含义 | TTL 设置 |
|---|---|---|
| 1 | 冻结 3 天 | 设 3 天过期 |
| 2 | 冻结 7 天 | 设 7 天过期 |
| 3 | 永久冻结 | 不设 TTL,只有解冻接口能删 |
一条 SET key value EX days 同时覆盖两种语义,不需要额外定时任务去「到期自动解冻」,Redis 的过期机制就是现成的定时器。这也是选 Redis 的附带红利:如果状态存 MySQL,定期冻结还得配一个扫表任务。
还有一个实读中发现的坑,必须单独说。配套资料和工程代码里,冻结时长的注释写着「1 为冻结 3 天,2 为冻结 7 天」,但实际的过期时间单位用的是 TimeUnit.MINUTES:
// 工程原码(ManagerService.userFreeze,节选)
if(days>0) {
redisTemplate.opsForValue().set(key,value,days, TimeUnit.MINUTES);
}
按这个写法,「冻结 3 天」实际上是冻结 3 分钟、7 天是 7 分钟,教学环境里为了演示「到期自动解冻」的效果方便,但这是与注释语义相悖的。生产代码这里应当是 TimeUnit.DAYS。读代码时单位不核对注释,这类 bug 很容易溜进线上。
C 端校验位置
这是整篇的技术核心。理论上校验点有两个,工程实读的结论是:项目工程实际只做了登录链路校验,Token 拦截器方案是配套资料层面的思路扩展。两处分开说。
登录链路校验(工程实际做法)
冻结范围 1 对应「冻结登录」,拦的位置不是登录接口本身,而是更靠前的发短信验证码接口。实读 mf-app-server 的 UserService.sendMsg(UserService.java:51):
public void sendMsg(String phone) {
//根据手机号查询用户,如果用户存在,判断是否被冻结
User user = userApi.findByMobile(phone);
if(user != null) {
userFreezeService.checkUserStatus("1",user.getId());
}
//后续:生成验证码、写入 Redis(CHECK_CODE_{phone},5 分钟)
}
为什么拦在发验证码这一步?登录是「发验证码 → 校验验证码 → 签发 token」两段式的,验证码都发不出去,后面的登录必然走不通。而且在入口处拦截还能省一次短信费用,被冻结的用户连验证码都不该收到。
校验逻辑统一收敛在 UserFreezeService.checkUserStatus(mf-app-server/.../service/UserFreezeService.java):
public void checkUserStatus(String state, Long userId) {
//1、拼接key,从redis中查询数据
String key = Constants.USER_FREEZE + userId;
String value = redisTemplate.opsForValue().get(key);
//2、如果数据存在,且冻结范围一致,抛出异常
if(!StringUtils.isEmpty(value)) {
Map map = JSON.parseObject(value, Map.class);
String freezingRange = (String) map.get("freezingRange");
if(state.equals(freezingRange)) {
throw new BusinessException(ErrorResult.builder().errMessage("用户被冻结").build());
}
}
}
三个细节:
- key 不存在直接放行,绝大多数用户没被冻结,一次 Redis GET 就结束,这就是「O(1) 无性能压力」的含义
- 范围匹配才拦截,
state参数是「当前操作对应的冻结范围」,登录传"1";冻结范围是2(发言)的用户来登录,不会被拦 - 抛
BusinessException而不是返回值,工程里有全局异常处理器,抛出去之后自动构造错误响应给客户端,客户端直接展示「用户被冻结」的提示,业务代码里不用写任何响应拼装
工程快照里 checkUserStatus 只有 sendMsg 这一处调用。配套资料里补了一句:「发布动态和发布评论等接口也需要做相应的校验工作」,即评论接口传 ("2", userId)、动态接口传 ("3", userId),模式完全一样。完整接入留到代码实现篇。
Token 拦截器校验(思路扩展)
登录校验有个天然盲区:冻结前已经登录的用户,手里的 token 还没过期。只拦登录,他在线的这段时间照样能发动态。要「在线即踢」,就得在 C 端 TokenInterceptor 的 preHandle 里加一次冻结检查:
//伪代码:在解析 token 之后追加
User user = UserHolder.get();
userFreezeService.checkUserStatus("1", user.getId()); // 或按接口语义传对应范围
实读 mf-app-server 的 TokenInterceptor,当前它只做两件事:解析 token 取出 id/mobile、把 User 塞进 UserHolder(ThreadLocal),没有任何冻结校验。拦截器里加检查的代价是每个请求多一次 Redis GET,对这个量级(单次 GET 亚毫秒)完全可接受,比在拦截器里查 MySQL 强得多。
两种方案的对比:
| 维度 | 登录链路校验 | Token 拦截器校验 |
|---|---|---|
| 拦截对象 | 新登录(发验证码时) | 所有已登录请求 |
| 覆盖盲区 | 冻结前的存量 token 仍可用 | 无,在线用户下一次请求即被踢 |
| 性能开销 | 仅登录时一次 Redis GET | 每个请求一次 Redis GET |
| 工程实际 | 已实现(sendMsg 处) | 未实现,属改进方向 |
完整方案是两处都校验:登录必拒 + 在线即踢。仅做登录校验适合快速落地(项目工程的选择);要严格管控,就再往 TokenInterceptor 里加一层。两者不冲突,都是读同一个 key。
后台列表的状态回显
还有一处容易被忽略的「校验」:管理后台的用户列表和详情页要显示冻结状态。实读 ManagerService(ManagerService.java:41、ManagerService.java:54):
public UserInfo findUserById(Long userId) {
UserInfo userInfo = userInfoApi.findById(userId);
//查询redis中的冻结状态
String key = Constants.USER_FREEZE + userId;
if(redisTemplate.hasKey(key)) {
userInfo.setUserStatus("2");
}
return userInfo;
}
UserInfo 里的状态字段是 @TableField(exist = false) 的非表字段,默认 "1"(正常),key 存在就覆盖成 "2"(已冻结)。它不落库,因为冻结的事实源就是 Redis,后台展示只是把 Redis 状态翻译成人能看的标记。列表页 findAllUsers 对每个用户做同样的判断。
解冻流程
解冻简单到只有一行核心操作(ManagerService.userUnfreeze,代码见接口设计一节)。key 一删,C 端下一次 GET 就是 null,立即放行,解冻的即时性来自 Redis 的删除语义,不需要通知任何服务、不需要刷新缓存。定期冻结则是 TTL 到期自动删,殊途同归。
public Map userUnfreeze(Map params) {
String userId = params.get("userId").toString();
String key = Constants.USER_FREEZE + userId;
//删除redis数据
redisTemplate.delete(key);
Map retMap = new HashMap();
retMap.put("message","解冻成功");
return retMap;
}
实现步骤拆解
全流程四步,每步只依赖前一步产生的 key 约定:
| 步骤 | 工程 | 动作 | 核心操作 |
|---|---|---|---|
| 1. 管理端冻结 | mf-admin | 接收参数,写冻结状态 | SET USER_FREEZE_{userId} {参数JSON}(按需带 TTL) |
| 2. C 端登录校验 | mf-app-server | 发验证码前查状态并拒绝 | GET USER_FREEZE_{userId} → 范围匹配则抛异常 |
| 3. C 端接口校验 | mf-app-server | 评论/动态接口按范围校验(可扩展到 TokenInterceptor) | 同上,state 分别传 2/3 |
| 4. 管理端解冻 | mf-admin | 删除冻结状态 | DEL USER_FREEZE_{userId} |
伪代码层面,四步可以压成四行:
# 步骤1 管理端冻结(范围 + 时长由参数决定)
SET USER_FREEZE_106 '{"freezingTime":"1","freezingRange":"1",...}' EX 3天
# 步骤2/3 C 端校验(state = 当前操作的冻结范围)
value = GET USER_FREEZE_106
若 value 非空 且 value.freezingRange == state → 抛"用户被冻结"
# 步骤4 管理端解冻
DEL USER_FREEZE_106
异常与边界
| 场景 | 分析 | 工程处理 / 应对 |
|---|---|---|
| 管理员冻结自己 | 管理员不在 C 端用户体系内,理论上不会命中;若 userId 传成管理员 id,Redis 里写了条无效冻结记录,无实际影响 | 接口层校验 userId 必须是 C 端用户更稳妥;管理端与 C 端用户体系隔离(管理端走 AdminHolder,C 端走 UserHolder) |
| 重复冻结同一用户 | 第二次 set 会覆盖第一次(时长、范围以最后一次为准) | 幂等,SET 覆盖,新参数覆盖旧参数,不会产生脏数据;严格实现可在已冻结时提示「该用户已被冻结」 |
| 解冻未冻结的用户 | redisTemplate.delete(key) 对不存在的 key 不报错,正常返回「解冻成功」 | 天然幂等;严格实现可先 hasKey 判断并提示「该用户未被冻结」 |
| 永久冻结后再次临时冻结 | set 带 TTL 覆盖无 TTL 的旧值,冻结被「减轻」 | 覆盖逻辑要产品侧确认:是加重还是重置,避免管理员误操作 |
| 已登录用户的 token / 冻结期间已发放的 token | 工程的 TokenInterceptor 不查冻结,冻结前已登录的用户 token 仍然有效,可继续浏览 | 取舍:拦截器全量校验会拖累所有请求,而冻结核心诉求是「禁新内容、禁登录」;若要立即踢下线,可在拦截器接冻结校验(方案 B)或走网关黑名单(方案 C) |
| 冻结范围与业务不匹配 | 只冻结「发言」的用户仍能重新登录,符合产品预期 | checkUserStatus 按范围比对,各业务入口传各自的范围值 |
| 误冻结申诉 | 冻结记录含原因、备注,可支撑申诉复核 | 解冻接口就是申诉的出口,解冻需填备注留痕 |
| Redis 数据丢失 | 冻结状态消失,被冻结用户恢复自由 | 生产应双写 MySQL 流水,Redis 丢失可重建(教学工程未做) |
| freezingTime/Range 传非法值 | 走默认分支 | freezingTime 非 1/2/3 时 days=0,按永久冻结处理,严格场景应在入口校验参数 |
Redis 丢失:要不要 MySQL 兜底
一个有意思的素材冲突:配套资料开头写「后台中解冻/冻结,就是将用户状态写入数据库中」,但工程实读下来冻结/解冻全程只碰 Redis,没有任何落库代码,UserInfo.userStatus 也是 exist = false 的展示字段。配套资料描述的是概念模型,代码是教学简化版。
生产环境怎么做,取决于冻结的「严肃程度」:
- 惩罚性质的短期冻结(3 天/7 天):Redis 丢了影响有限,等 TTL 场景重建即可,可以接受单点存储
- 违规存档、永久封号这类必须留痕的状态:以 MySQL 为事实源(比如
tb_user加user_status字段),Redis 只做加速层,冻结时双写,校验时优先查 Redis
项目工程的取舍是前者,用 TTL 表达「冻结 3 天」这种会自然消失的状态,省掉了双写一致性的复杂度。这个取舍本身比代码更值得记住:状态放哪,取决于它丢失的代价,而不是技术偏好。
验证要点
端到端验证走一条完整链路:
- 管理端登录后台,进入用户管理,选择目标用户,发起冻结(3 天,范围「登录」);
redis-cli执行GET USER_FREEZE_106,确认冻结 JSON 写入、TTL返回剩余时间;- C 端用该用户手机号走登录流程,发送验证码接口应返回「用户被冻结」,收不到验证码;
- 管理端执行解冻,
GET USER_FREEZE_106返回 nil; - C 端重新走登录流程,验证码正常下发,登录成功;
- 再冻结一次(7 天),不干预,观察 TTL 到期后 key 自动消失,自动解冻生效。
前五步验证「管得住」,第六步验证「放得开」,两者都过才算闭环。
功能联调也可按这条链再走一遍,确认细节:
- 管理端调
POST /manage/users/freeze,body 传{"userId":"106","freezingTime":"1","freezingRange":"1"},返回「冻结成功」 redis-cli执行GET USER_FREEZE_106,确认 JSON 已写入且 TTL 正确(教学快照下是 3 分钟)- 该用户手机号在 C 端请求发送验证码 → 应返回「用户被冻结」,且
CHECK_CODE_{phone}未生成 - 换一个冻结范围
freezingRange=2重复冻结 → 该用户登录应放行(范围不匹配) - 管理端调
POST /manage/users/unfreeze→redis-cli确认 key 已删除 → C 端登录恢复正常 - 后台用户详情页 → 冻结期间
userStatus显示"2",解冻后恢复"1"
常见误解澄清
| 误解 | 事实 |
|---|---|
冻结状态存在 tb_user 表的某个字段里 / MySQL 的 tb_user 里 | 实读工程 tb_user 只有 id/mobile/password,UserInfo 上的 userStatus 是 @TableField(exist = false) 的非表字段,状态完全存 Redis |
| 冻结等于封号,永久失效 | 冻结是临时性惩罚,支持 3 天/7 天自动到期和手动解冻;永久冻结才是封号语义 |
| 冻结后该用户所有功能都不可用 | 不一定,冻结范围可细分:冻结「发言」的用户仍可登录浏览,只是不能评论、发动态 |
| C 端需要轮询管理端获知冻结状态 | 不需要,两边共享同一个 Redis,C 端请求时实时 GET 即可 |
| 冻结三天到期后需要人工解冻 | 不需要,Redis TTL 到期 key 自动删除,查询不到冻结记录即视为正常 |
| value 只是简单的冻结标记 | 是参数整包 JSON,包含冻结范围、时长等,C 端要按 freezingRange 比对才能支持精细化限制 |
| 冻结了就登录不上了,因为 token 失效 | token 本身没动。当前工程拦的是发验证码环节,存量 token 在有效期内依然可用 |
| 冻结 N 天需要写定时任务到期解冻 | 不需要。Redis TTL 到期自动删 key,校验端 GET 为 null 自然放行 |
| 永久冻结就是 TTL 设 100 年 | 直接不设 TTL 的 SET,过期语义交给解冻接口 |
| 每个冻结用户一个独立的校验逻辑 | 只有一套 checkUserStatus(state, userId),范围差异体现在 state 参数上 |
| 解冻后要通知 C 端刷新缓存 | 没有缓存可刷,删除 key 即全局生效 |
总结
- 用户冻结解冻的产品语义不复杂:管理员发起、可临时可永久、按范围限制登录/发言/发动态。真正值得消化的是两个设计决策,联动上,项目选了「业务入口逐点校验」而不是拦截器全量拦截,用最小开销对准了「冻结范围」这个产品概念;存储上,用 Redis TTL 把「到期自动解冻」从一个定时任务问题变成一行
set参数,代价是牺牲了持久性,生产环境需要补上 MySQL 流水做事实源。 - 冻结状态存 Redis:key 为
USER_FREEZE_{userId},value 是完整冻结参数的 JSON,范围控制全靠 value 里携带的freezingRange;TTL 的取舍上,定期冻结用 Redis 过期替代定时任务,永久冻结不设 TTL;教学快照里TimeUnit.MINUTES是演示用的坑,生产应为TimeUnit.DAYS。 - 校验位置:工程实际在发验证码接口拦登录(
checkUserStatus),Token 拦截器校验是补「在线即踢」盲区的扩展方向,两者读同一个 key、可以叠加;后台列表与详情页的userStatus是非表字段,靠查 Redis 回显,不落库。 - 解冻即删 key,即时生效;重复冻结/解冻天然幂等。状态丢失的代价决定事实源选型:短期惩罚可只靠 Redis,永久封号应 MySQL 兜底。
冻结的「为什么」和「存哪里」理清了,下一篇同一模块的用户冻结解冻:思路分析接着拆「怎么做」,冻结与解冻的具体实现步骤和各业务入口的接入细节。
3117



被折叠的 条评论
为什么被折叠?



