Java 项目实战: 交友项目 - 用户冻结解冻

ch32v103xx 烧写 烧写方式 串口uart, usb,swd(wch link)但不建议按此使用,参官方说明。 阅读详情

概述

用户冻结解冻是管理员在后台对违规用户施加的惩罚措施:临时或永久地禁止其登录、评论、发动态。这里从产品语义、跨系统联动方案与存储选型讲起,再拆到具体落地,管理端一按键,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/freezeuserId、freezingTime、freezingRange、冻结原因、备注Map(message)
用户解冻POST/manage/users/unfreezeuserId、解冻原因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 承载。

C端用户(mf-app-server)Redismf-adminManagerService管理端(管理员)C端用户(mf-app-server)Redismf-adminManagerService管理端(管理员)用户尝试登录或临时冻结到期,TTL 到,key 自动删除POST /manage/users/freeze(userId, freezingTime, freezingRange, remarks)SET USER_FREEZE_106 {params JSON} EX 3天{"message":"冻结成功"}sendMsg(phone) 发送验证码GET USER_FREEZE_106{freezingRange:"1",...}freezingRange 匹配"登录"→ 抛 BusinessException响应"用户被冻结",登录被拒POST /manage/users/unfreeze(userId, remarks)DEL USER_FREEZE_106{"message":"解冻成功"}GET USER_FREEZE_106nil校验通过,登录恢复正常

冻结状态存哪里:Redis 还是 MySQL

冻结数据要有地方放。需求分析篇已经比过三种方案,这里从实现角度补一个关键理由:冻结校验发生在 C 端的高频链路上。登录、发评论、发动态,每一次请求都可能要查一次冻结状态:

  • 放 MySQL:每条请求多一次 DB 查询,还得给表加索引、管连接池,收益却是「管理员偶尔才冻结一个人」这种低频写
  • 放 Redis:GET 一个 key,O(1),单机 Redis 轻松扛几万 QPS,对既有链路的延迟影响可以忽略

而管理端的写操作(冻结/解冻)一天没几次,Redis 完全兜得住。读写频率的巨大反差,决定了状态放 Redis。

两条路的整体对比:

维度MySQLRedis
持久性强,重启不丢弱,故障或内存淘汰可能丢数据
临时冻结的到期处理需要定时任务扫描过期记录再解冻设置 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端 mf-app-serverRedis管理端 mf-admin被冻结用户C端 mf-app-serverRedis管理端 mf-admin冻结状态生效新登录被拦 + 存量token仍可发请求(盲区)解冻即时生效SET USER_FREEZE_106 {参数JSON} (EX 3天)请求发送验证码(登录第一步)GET USER_FREEZE_106冻结JSON(freezingRange=1)BusinessException「用户被冻结」DEL USER_FREEZE_106再次请求发送验证码GET USER_FREEZE_106null正常下发验证码,登录恢复

异常与边界

场景分析工程处理 / 应对
管理员冻结自己管理员不在 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 天」这种会自然消失的状态,省掉了双写一致性的复杂度。这个取舍本身比代码更值得记住:状态放哪,取决于它丢失的代价,而不是技术偏好。

验证要点

端到端验证走一条完整链路:

  1. 管理端登录后台,进入用户管理,选择目标用户,发起冻结(3 天,范围「登录」);
  2. redis-cli 执行 GET USER_FREEZE_106,确认冻结 JSON 写入、TTL 返回剩余时间;
  3. C 端用该用户手机号走登录流程,发送验证码接口应返回「用户被冻结」,收不到验证码;
  4. 管理端执行解冻,GET USER_FREEZE_106 返回 nil;
  5. C 端重新走登录流程,验证码正常下发,登录成功;
  6. 再冻结一次(7 天),不干预,观察 TTL 到期后 key 自动消失,自动解冻生效。

前五步验证「管得住」,第六步验证「放得开」,两者都过才算闭环。

功能联调也可按这条链再走一遍,确认细节:

  1. 管理端调 POST /manage/users/freeze,body 传 {"userId":"106","freezingTime":"1","freezingRange":"1"},返回「冻结成功」
  2. redis-cli 执行 GET USER_FREEZE_106,确认 JSON 已写入且 TTL 正确(教学快照下是 3 分钟)
  3. 该用户手机号在 C 端请求发送验证码 → 应返回「用户被冻结」,且 CHECK_CODE_{phone} 未生成
  4. 换一个冻结范围 freezingRange=2 重复冻结 → 该用户登录应放行(范围不匹配)
  5. 管理端调 POST /manage/users/unfreeze → redis-cli 确认 key 已删除 → C 端登录恢复正常
  6. 后台用户详情页 → 冻结期间 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 兜底。

冻结的「为什么」和「存哪里」理清了,下一篇同一模块的用户冻结解冻:思路分析接着拆「怎么做」,冻结与解冻的具体实现步骤和各业务入口的接入细节。

SMOKE 3D:从 Python 到 C++ 实现车辆与行人单目 3D 视觉识别在 RK3588 上的深度部署 SMOKE的网络结构通常基于高性能的骨干网络(如DLA-34,您使用的模型就是基于此),通过编码器-解码器架构来提取特征。输入:RGB图像(本项目为骨干网络:用于特征提取。检测头热力图分支:预测关键点热力图。通常在热力图上进行NMS来找到局部最大值,即潜在的关键点位置。回归分支:对于每个关键点位置,预测上述的8维3D属性向量。分类分支:预测每个关键点对应的物体类别。置信度分支:预测每个关键点的置信度。本教程详细介绍了SMOKE单目3D目标检测模型在RK3588上的部署。我们从SMOKE的。 阅读详情

相关推荐

【邻接表存图模板】vector邻接表、数组邻接表、链式前向星

一、目录 一、目录 二、前言 三、邻接表“详解” (一)边的信息 (二)几种邻接表的实现方法“详解” 1.数组邻接表 代码 2.vector邻接表 代码 vector邻接表还有一种魔性写法: 3.链式前向星 代码 四、总结 二、前言 本来之前自己太弱了,一直只会用邻接矩阵,后来发现邻接表才是主流... 参考&特别鸣谢: https://www.cnblog...

十里寒塘路♣烟花一半醒 3117

【Spring开发】SpringCloud交友项目实战第2篇:介绍 《明日交友》,1、项目介绍【附代码文档】

1、Dubbo的前世今生 1、项目介绍 1.1、项目背景 1.2、市场分析 1.3、目标用户群体 1.4、使用场景 1.5、竞争对手分析 1.7、技术方案 2、前后端分离开发思想 3、开发工具与环境搭建 3.1、开发工具 3.2、环境搭建 4、sms_code验证玛 4.1 阿里云短信 4.2 自动装配 1. 完善用户信息 1.2 百度人脸识别 1.2.1 概述 1.2.2 账号申请 1.2.4 抽取模板工具 2.2 更新用户资料 2.2.1 接口文档 2.2.2 代码实现 3. 统一token处理 3.1

小帅说java 858

利用ArcGIS快速生成等高线边界,完成地形图拼图

地形图边界一般在CAD中手动绘制,然而,一幅边缘复杂的地形图边界的绘制需要花费大量时间和精力,为了减少重复性工作,提高效率,用ArcGIS软件可以自动生成实测地形图的边界

yl14774636230的博客 9073

【Spring开发】SpringCloud交友项目实战第5篇:1.3 保存用户信息,2.2 更新用户资料【附代码文档】

1、Dubbo的前世今生 1、项目介绍 1.1、项目背景 1.2、市场分析 1.3、目标用户群体 1.4、使用场景 1.5、竞争对手分析 1.7、技术方案 2、前后端分离开发思想 3、开发工具与环境搭建 3.1、开发工具 3.2、环境搭建 4、sms_code验证玛 4.1 阿里云短信 4.2 自动装配 1. 完善用户信息 1.2 百度人脸识别 1.2.1 概述 1.2.2 账号申请 1.2.4 抽取模板工具 2.2 更新用户资料 2.2.1 接口文档 2.2.2 代码实现 3. 统一token处理 3.1

小帅说java 649

电源完整性之Cadence Sigrity Power SI_AC阻抗仿真

之前和大家分享过电源完整性之仿真设计原理链接: [link](https://blog.youkuaiyun.com/weixin_41808082/article/details/117065140?spm=1001.2014.3001.5501).今天接着上一篇文章总结一下电源AC阻抗的的仿真操作流程及一些simulation中的设置参数,用到的时候Cadence Sigrity 中的Power SI组件,下面开始享受仿真的快乐吧: 1.仿真模式选择与文件导入 选择Cadence Sigrity下的Power SI

刘小同学的博客 1万+

Spark入门:从零到能跑的实战教程

Spark 的强大在于它统一了大数据处理的多种场景,从批处理到流处理,从 SQL 到机器学习。对于初学者来说,理解 Spark 的核心理念——内存计算和分布式抽象,是最重要的一步。接着,学会用 PySpark 搭建环境,能读数据、能写 SQL,基本上就入门了。剩下的路,就是通过实战去加深理解。写到这里,相信你对 Spark 已经有了一个比较完整的认识。下一步,不妨自己动手写几个 PySpark 脚本,跑一跑日志数据,或者尝试用 Spark SQL 做一个统计。

Morpheon的博客 1371

探花交友10-数据统计与内容审核

Target({//动态获取方法参数,支持SpringEL String objId() default "";//路由的key String key();//日志类型 String type();

InLoadwetrust的博客 1319

ROS相机内参标定详细步骤指南

相机标定的目的是为了确定相机内部参数和外部参数,以便修正图像并将图像坐标映射到世界坐标,或者从世界坐标映射到图像坐标。这个过程是计算机视觉和三维感知任务的关键步骤之一,它有以下主要目的: 1. **减小畸变**:相机镜头和传感器可能引入径向和切向畸变,使得图像中的直线变得弯曲或者物体的形状不准确。通过标定相机,可以矫正这些畸变,使图像更准确。

m0_56661101的博客 1万+

【Spring开发】SpringCloud交友项目实战第7篇:MongoDB入门【附代码文档】

1、Dubbo的前世今生 1、项目介绍 1.1、项目背景 1.2、市场分析 1.3、目标用户群体 1.4、使用场景 1.5、竞争对手分析 1.7、技术方案 2、前后端分离开发思想 3、开发工具与环境搭建 3.1、开发工具 3.2、环境搭建 4、sms_code验证玛 4.1 阿里云短信 4.2 自动装配 1. 完善用户信息 1.2 百度人脸识别 1.2.1 概述 1.2.2 账号申请 1.2.4 抽取模板工具 2.2 更新用户资料 2.2.1 接口文档 2.2.2 代码实现 3. 统一token处理 3.1

小帅说java 783

Polyworks脚本开发实战指南:高效生成数据彩图与报告的关键指令解析

本文深入解析了Polyworks脚本开发中生成数据彩图与自动化报告的核心指令。通过实战案例,详细介绍了REFERENCE_SURFACE、THICKNESS和CLEARANCE等关键彩图生成指令的正确用法与常见避坑点,并阐述了如何利用REPORT_ITEM命令实现从截图、表格生成到智能排版的全流程自动化,旨在帮助三维检测与质量控制工程师大幅提升工作效率与报告标准化水平。

weixin_29209825的博客 558

[Dify]-进阶5- 使用 Dify 构建多轮对话的客服机器人

本文介绍了如何利用Dify平台构建智能客服系统,重点阐述了ChatFlow框架的应用。系统支持多轮对话、业务接口集成和话术策略管理,具备订单查询、退货申请等核心功能。通过Classifier节点实现意图识别,借助Router节点分流处理流程,并结合API插件实现业务数据对接。文章还提供了部署调试、会话优化和监控分析的具体方法,强调模块化设计和插件化集成的重要性,为构建功能完善的智能客服系统提供了完整解决方案。

技术小甜甜:传播可落地技术,帮助个人和企业降低解决真实场景问题的成本 1663

SpringBoot交友APP项目实战(详细介绍+案例源码) - 11.后台管理(完结啦)

搭建一个Java框架的移动端交友APP,涵盖登录、注册、动态、即时通讯、视频(算法推荐)、个人中心等功能; 技术选型: Spring Boot + SpringMVC + Mybatis + MybatisPlus + Dubbo,即时通讯选用环信即时通讯

yuan 5550

Windows 11 WSL2环境下OpenClaw部署的兼容性问题分析与解决方案研究

本文研究了OpenClaw在Windows 11 WSL2环境下的部署方案。WSL2通过无缝集成Linux与Windows系统,为OpenClaw提供了良好的运行环境,支持GPU加速和跨平台开发。文章详细分析了硬件配置要求(推荐8核CPU/16GB内存/NVMe SSD)、系统选择(Windows 11 Pro+Ubuntu 22.04)以及部署步骤,包括WSL2启用、Linux发行版安装、Python/Node.js/Redis等依赖配置。通过优化.wslconfig文件参数(如内存分

博客 2284

【Spring开发】SpringCloud交友项目实战第4篇:介绍,1. 完善用户信息【附代码文档】

1、Dubbo的前世今生 1、项目介绍 1.1、项目背景 1.2、市场分析 1.3、目标用户群体 1.4、使用场景 1.5、竞争对手分析 1.7、技术方案 2、前后端分离开发思想 3、开发工具与环境搭建 3.1、开发工具 3.2、环境搭建 4、sms_code验证玛 4.1 阿里云短信 4.2 自动装配 1. 完善用户信息 1.2 百度人脸识别 1.2.1 概述 1.2.2 账号申请 1.2.4 抽取模板工具 2.2 更新用户资料 2.2.1 接口文档 2.2.2 代码实现 3. 统一token处理 3.1

小帅说java 872

Outlook Express 6 (OE6) for Win7/Win8/Win10

英文版 Outlook Express6.0, 兼容Win7/Win10/WinXP,解压就可用。

STM32F407中文手册

STM32f407中文手册 本参考手册面向应用开发人员,提供有关使用 STM32F405xx/07xx、STM32F415xx/17xx、 STM32F42xxx 和 STM32F43xxx 微控制器存储器与外设的完整信息。STM32F405xx/07xx、STM32F415xx/17xx、STM32F42xxx 和 STM32F43xxx 构成一个微 控制器系列,各产品具有不同的存储器大小、封装和外设。有关订购信息以及器件的机械与电气特性,请参见数据手册。有关 ARM Cortex™-M4F 内核的信息,请参见《Cortex™-M4F 技术参考手册》。

Java 项目实战:交友项目 —— 项目导读与整体架构

本文以陌生人社交App为练手项目,系统梳理了基于Dubbo与SpringCloud的微服务架构设计。项目涵盖C端(交友、动态、聊天)与B端(用户管理、内容审核)功能,采用分层架构:接入层(网关)、应用层(业务编排)、域服务层(Dubbo提供可复用能力)、数据层(MySQL/MongoDB/Redis等)。通过模块化设计实现高复用性,明确各技术栈(如Nacos、RabbitMQ、Easemob)在具体业务中的落点,并给出完整学习路径与工程结构,帮助开发者从零搭建真实可用的分布式系统。

Wang的专栏 633

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

【Spring开发】SpringCloud交友项目实战第6篇:3. 统一token处理【附代码文档】

1、Dubbo的前世今生 1、项目介绍 1.1、项目背景 1.2、市场分析 1.3、目标用户群体 1.4、使用场景 1.5、竞争对手分析 1.7、技术方案 2、前后端分离开发思想 3、开发工具与环境搭建 3.1、开发工具 3.2、环境搭建 4、sms_code验证玛 4.1 阿里云短信 4.2 自动装配 1. 完善用户信息 1.2 百度人脸识别 1.2.1 概述 1.2.2 账号申请 1.2.4 抽取模板工具 2.2 更新用户资料 2.2.1 接口文档 2.2.2 代码实现 3. 统一token处理 3.1

小帅说java 1078

android 蓝牙通讯demo

android 下蓝牙通讯demo,实现了发现蓝牙,使能蓝牙,通过蓝牙发送消息。

【Spring开发】SpringCloud交友项目实战第10篇:4. SpringData-Mongo,5. 今日佳人【附代码文档】

1、Dubbo的前世今生 1、项目介绍 1.1、项目背景 1.2、市场分析 1.3、目标用户群体 1.4、使用场景 1.5、竞争对手分析 1.7、技术方案 2、前后端分离开发思想 3、开发工具与环境搭建 3.1、开发工具 3.2、环境搭建 4、sms_code验证玛 4.1 阿里云短信 4.2 自动装配 1. 完善用户信息 1.2 百度人脸识别 1.2.1 概述 1.2.2 账号申请 1.2.4 抽取模板工具 2.2 更新用户资料 2.2.1 接口文档 2.2.2 代码实现 3. 统一token处理 3.1

小帅说java 815

【Spring开发】SpringCloud交友项目实战第11篇:分片集群【附代码文档】

1、Dubbo的前世今生 1、项目介绍 1.1、项目背景 1.2、市场分析 1.3、目标用户群体 1.4、使用场景 1.5、竞争对手分析 1.7、技术方案 2、前后端分离开发思想 3、开发工具与环境搭建 3.1、开发工具 3.2、环境搭建 4、sms_code验证玛 4.1 阿里云短信 4.2 自动装配 1. 完善用户信息 1.2 百度人脸识别 1.2.1 概述 1.2.2 账号申请 1.2.4 抽取模板工具 2.2 更新用户资料 2.2.1 接口文档 2.2.2 代码实现 3. 统一token处理 3.1

小帅说java 811

西安聚合CPS优惠券系统源码实战开发指南与完整项目解析

其中`SpringBoot`负责RESTful API与业务逻辑,`MyBatis Plus`简化数据库操作,`MySQL`存储用户、订单、优惠券等核心表。该系统主要面向西安本地商超、餐饮、外卖场景,通过聚合美团、饿了么等平台CPS优惠券,为用户提供“霸王餐”入口、折扣券领取、分享返佣等功能。建议在后台配置“动态分佣比例”,根据商户类型(新客/老客)自动调整。1. **数据一致性优先**:优惠券的领取与核销涉及多平台回调,务必使用分布式事务框架(如Seata)或“本地消息表+定时补偿”方案,避免多发券。

weixin_42804741的博客 236

拼桌活动新玩法,JAVA报名系统来助力

基于JAVA技术的拼桌报名系统创新社交玩法,通过主题匹配、盲盒随机、竞价拍卖和任务互动四大功能重构传统拼桌模式。系统采用高并发架构、实时数据同步和智能防作弊机制,支持万人同时抢桌和秒级状态更新。案例显示,某日料店盲盒拼桌活动使成局率达92%,用户社交时长延长至2.5小时。JAVA技术赋能使拼桌从功能性需求升级为精准社交体验,未来可结合AI推荐实现更智能的匹配。

小马总的博客 1140

InnoDB 内存结构总览:Change Buffer、AHI 与 Log Buffer

本文系统梳理InnoDB内存结构中的ChangeBuffer、Adaptive Hash Index(AHI)与LogBuffer。ChangeBuffer缓存二级索引页不在内存时的变更,减少随机IO,仅在页加载时合并;聚簇索引修改立即执行,因数据本身不可延后。AHI基于高频等值查询自动构建哈希索引,加速定位,仅支持等值操作。LogBuffer为redo log内存缓冲,配合磁盘日志实现崩溃恢复。三者均服务于性能优化,其中ChangeBuffer与AHI共享BufferPool空间,而LogBuffer独立

bksczm的博客 310

信创环境下PageOffice文档控件适配与实践

信创适配做到文档控件这一层,拼的已经不是"有没有国产版本",而是同一个功能在两类终端上是否真的等价。等价的标准很具体:同一次点击能得到同样的结果,同一份公文能得到同样的版式,同一个项目不需要维护两套代码。这背后是三件并不轻松的工作:服务端用一套接口同时支撑两类终端,客户端把两种系统与四种芯片的安装包分发清楚,文档内核层由产品侧跟着 WPS 的版本走。浏览器这一层的压力,则被收进了产品自己的窗口里——升级节奏由产品掌握,不再交给运气。

zi_wu_xian的专栏 336

第三篇 第 6 课

前置:第三篇第 1 课(stdx 引入),第二篇第 1 课(std.regex)。环境:仓颉 SDK 1.2.0。本文所有代码与输出均逐行实测。

weixin_41618057的博客 557

【从零理解 Spring AI · 12】MCP 的两种角色:做客户端还是做服务端

上一篇讲了 MCP 的概念:标准协议、三大角色、M+N 替代 M×N。

nice_lcj520的博客 615

pcl2启动器下载(Minecraft PCL2 启动器 最新版 安装与使用说明)

摘要:PCL2(Plain Craft Launcher 2)是一款面向 Minecraft 的第三方启动器,支持正式版与快照版本管理、模组与整合包安装、Java 运行时自动匹配,绿色免安装、双击即可运行。适合在 Windows 上玩单机整合包、需要多版本共存或离线启动的用户使用

2611_96675819的博客 226

spring boot 4集成SQLLite,及其SQLLite的建库

spring boot 4集成SQLLite,及其SQLLite的建库

weixin_41463944的博客 237
上一篇: Java 项目实战: 交友项目 - 数据统计与内容审核:任务总览
下一篇: Java 项目实战: 交友项目 - 用户冻结的代码实现
Wang's Blog
博客等级 码龄12年 7440粉丝 2427原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Wang's Blog

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值