概述
前面几个模块的功能基本都围绕 C 端用户展开,但一个产品要活下去,还差三块运营侧的能力:用户冻结解冻(风控闭环)、数据统计(定时任务 + 日志采集)、内容审核(阿里云审核 + MQ 异步)。这里是这套改造的开篇导引,先盘清这三件事各自要做什么、和前面的代码怎么衔接,再给出工程代码全景图,方便读者带着任务清单往下读。
纲要
- 前情回顾:小视频方案做了什么,产出在这里如何被复用
- 任务清单:三大板块的目标、产出物与验收标准
- 用户冻结解冻:管理端写 Redis,C 端登录/发言/发动态被拦截
- 数据统计:MQ 日志采集 + CRON 定时统计 + 首页看板
- 内容审核:发布动态 → MQ → 后台调阿里云审核 → 回写 state
- 三条依赖链的关系图(重点看审核这条跨系统异步链)
- 新增代码预览(工程实测目录树)
- 阅读建议与常见误解澄清
前情回顾:小视频方案的产出怎么用
小视频模块做完后,工程里留下了三块可以直接复用的资产:
| 小视频方案做的事 | 产出 | 具体做法 |
|---|---|---|
| 视频上传走 FastDFS | SmallVideosService 上传链路、video 存储表 | 审核图片时同一套媒体存储思路,审核结果直接作用于已发布内容 |
| SpringCache 缓存闭环 | RedisCacheConfig + @Cacheable 推荐视频列表 | 冻结/统计场景同样以 Redis 为状态载体,缓存思维延续 |
| 发布链路(动态/视频落库) | MovementService、SmallVideosService 发布方法 | 发布时写入的 state = 0(待审核)记录,现在由审核流程接管更新 |
这里要特别点出一个「埋点」:动态发布实现时,Movement 文档里预留了 state 字段,0 待审核、1 审核通过、2 审核驳回。当时所有动态发布后 state 固定为 0,列表查询时也未做强过滤,等于审核闸门只装了门框没装锁。登录注册流程里那句「用户被冻结」的异常提示同样只是引子,没有真正的冻结机制。这里把这两处欠账全部结清。
任务清单
按工程的实际顺序(用户冻结解冻 → 数据统计 → 内容审核),三大板块的任务、产出与验收标准如下:
| 板块 | 做什么 | 产出物 | 验收标准 |
|---|---|---|---|
| 用户冻结解冻 | 管理端 mf-admin 写冻结状态到 Redis(支持 3 天/7 天/永久),C 端 mf-app-server 在登录、评论、发动态前校验 | ManagerService.userFreeze/userUnfreeze、UserFreezeService.checkUserStatus | 闭环验证:管理端冻结某用户后,该用户在手机端登录/发言/发动态被拒;解冻后恢复 |
| 数据统计 | 交友系统把用户操作日志(登录、发动态、浏览等)发到 RabbitMQ,后台消费落库;再用定时任务按天汇总进统计表 | MqMessageService.sendLogMessage、LogListener、LogMapper、AnalysisTask、AnalysisService | 日志表 tb_log 有持续新增记录;统计表 tb_analysis 定时任务跑完后有当天数据 |
| 首页统计看板 | 后台首页展示累计注册用户、今日新增、登录次数、近几日活跃度 | DashboardController + AnalysisService 查询(工程快照中查询逻辑集中在 AnalysisService) | 首页接口返回真实统计数据,不再是写死的假数字 |
| 内容审核 | 发布动态后发 MQ 消息,后台监听后调用阿里云内容安全做文本+图片审核,按结果回写 state | MqMessageService.sendAuditMessage、AuditListener、AliyunGreenTemplate、GreenProperties | 违规动态被驳回:构造含敏感词的动态,发布后 state 被更新为 2;正常内容 state 变为 1 |
注意冻结这块的时间单位:配套资料示例里 days 虽然语义是「天」,但代码用 TimeUnit.MINUTES 存储,方便本地演示快速过期,实际项目应改回 TimeUnit.DAYS,这点在第 1 篇详解时会展开。
三条依赖链
三个板块各自成链,但共享同一个特点:管理端与 C 端是两个独立系统,靠 Redis 或 MQ 建立联系,而不是直接方法调用。
审核这条链最值得琢磨:发布动作和审核动作分属两个系统,发布方不关心审核结果何时出来,只负责把动态 id 扔进 MQ;后台监听到消息后再同步调阿里云接口。这就是典型的发布-订阅解耦,也是本文 MQ 知识的落点。
新增代码预览
工程快照(mf/10-数据统计与内容审核/01-代码)实测新增/修改的类如下:
mf
├── mf-admin # 管理后台
│ └── src/main/java/com/mf/admin
│ ├── controller
│ │ └── ManagerController.java # 修改:新增 /users/freeze、/users/unfreeze
│ ├── listener
│ │ ├── LogListener.java # 新增:消费日志消息,落库 tb_log
│ │ └── AuditListener.java # 新增:消费审核消息,调阿里云并回写 state
│ ├── mapper
│ │ ├── LogMapper.java # 新增:日志表操作
│ │ └── AnalysisMapper.java # 新增:统计表操作
│ ├── service
│ │ ├── ManagerService.java # 修改:userFreeze / userUnfreeze / 查询带冻结状态
│ │ └── AnalysisService.java # 新增:定时统计 + 首页看板查询
│ └── task
│ └── AnalysisTask.java # 新增:@Scheduled CRON 定时统计
├── mf-app-server # C 端
│ └── src/main/java/com/mf/server/service
│ ├── UserFreezeService.java # 新增:checkUserStatus 冻结校验
│ └── MqMessageService.java # 新增:发送日志消息 / 审核消息
└── mf-autoconfig # 自动配置模块
└── src/main/java/com/mf/autoconfig
├── properties
│ └── GreenProperties.java # 新增:阿里云内容安全配置项
└── template
└── AliyunGreenTemplate.java # 新增:文本垃圾检测 + 图片审核封装
测试代码里还多了 GreenTemplateTest 和 LogTest,分别用来单独验证阿里云审核连通性和日志消息收发,调试时可以先跑这两个再联调全链路。
阅读建议
- 精读 MQ 异步链。审核链路(发布 → MQ → 监听 → 阿里云 → 回写 state)覆盖了交换机/队列绑定、可靠投递、消费幂等三个高频面试考点,建议对照
AuditListener的@QueueBinding注解逐行看懂。 - 冻结是「跨系统状态联动」的最小案例。没有 MQ、没有 RPC,一个 Redis key 就让两个独立系统达成一致,理解了这个,再回头看「为什么不用数据库字段、为什么要 TTL」就有体感了。
- 定时任务部分重点掌握 CRON 表达式的六个字段和
@EnableScheduling的开启位置,统计 SQL 属于耐心的堆积,不必逐行背。
常见误解澄清
| 误解 | 实际情况 |
|---|---|
| 冻结就是把数据库 user 表的状态字段改掉 | 冻结状态存 Redis(带 TTL,天然支持「冻结 3 天」),数据库只做兜底查询展示 |
| 审核是发布动态时同步完成的 | 发布只写 state=0 并发一条 MQ 消息,审核异步进行,期间动态对其他用户不可见 |
| 自动审核结果完全可信 | 阿里云返回 pass/block/review 三种建议,自动审核只处理 pass 与 block,存疑内容留待人工复审 |
| 数据统计需要实时计算 | 统计走「日志先落库、定时任务再汇总」的离线路线,看板读的是统计表而非原始日志 |
| 定时任务多实例部署没问题 | @Scheduled 集群下会重复执行,生产需加分布式锁或改用 xxl-job,这里单机演示不展开 |
下一篇
本阶段按顺序从用户冻结解冻开讲。第一篇是需求与思路分析:冻结范围怎么划分(登录 1 / 发言 2 / 发动态 3)、冻结时长怎么映射 Redis TTL、C 端在哪里插校验点。直接进入用户冻结解冻:需求分析即可。
总结
- 本文补齐运营侧三大能力:冻结(Redis 跨系统联动)、统计(MQ 采集 + 定时汇总 + 看板)、审核(阿里云 + MQ 异步回写 state)。
- 动态发布预留的 state 闸门和「用户被冻结」提示在这里全部闭环,发布内容从此有了安全兜底。
- 三个板块共用一个设计母题:管理端与 C 端解耦,靠 Redis 或 MQ 传递状态,这也是后面做任何中大型系统的通用思路。
8780



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



