概述
用户管理模块的四件查询已经全部落地,这篇不重复实现细节,只做一件事:把四篇里反复出现的套路提炼成可迁移的模式,并汇总踩过的坑。
纲要
- 这组内容做了什么:四个查询接口与调用链全景
- 四篇分工回顾:一张表快速定位
- 可复用模式提炼
- 管理端复用域服务,零直连数据库
- 跨存储分页的两种形态:MyBatis-Plus vs MongoTemplate
- 转 VO 与不转 VO 的不一致
- 敏感数据的合规意识
- 坑位汇总
- 动手任务:四个可动手的技术任务
- 常见误解澄清
这组内容做了什么
管理端的「用户管理」是四个纯查询:用户列表(MySQL 分页)、用户详情(单条查)、视频记录列表(跨域查 Mongo)、动态列表(跨域查 Mongo 再补用户信息转 VO)。这四个接口的 Controller/Service 写在 mf-admin 模块里,但一条 SQL、一条 Mongo 查询都没有写,所有数据访问都通过 @DubboReference 调用 mf-dubbo-service 暴露的 UserInfoApi、VideoApi、MovementApi 完成,管理端只做参数搬运和结果组装。这正是前面搭 Dubbo + Nacos 分层的回报时刻:C 端早写好的域服务,管理端直接复用。
调用链全景:
四篇分工回顾
| 篇目 | 解决的问题 | 关键产出 |
|---|---|---|
| 分页查询用户列表 | 管理端如何分页展示全量用户 | UserInfoApi.findAll + MyBatis-Plus selectPage,IPage 转 PageResult |
| 查看用户详情 | 如何按 id 取单个用户完整资料 | UserInfoApi.findById,实体直接返回 |
| 查看用户视频记录列表 | 管理端如何查 Mongo 里的视频 | VideoApi.findByUserId,count + skip/limit 手工分页 |
| 查看动态列表 | 如何查动态并带上发布者信息 | MovementApi.findByUserId + 批量查 UserInfo 拼 MovementsVo |
可复用模式提炼
模式一:管理端复用域服务,零直连数据库
四篇的 Service 全是同一个形态,@DubboReference 注入 Api,一行调用:
public PageResult findAllVideos(Integer page, Integer pagesize, Long uid) {
return videoApi.findByUserId(page, pagesize, uid);
}
管理端没有任何 Mapper、没有数据源配置里的业务库连接。好处在加第二个消费端(后台系统)时显现:数据访问逻辑只有一份,改分页规则、改表结构只动 mf-dubbo-db / mf-dubbo-mongo。对比单体做法「新模块直接 @Autowired Mapper 查库」,这是分层架构真正的回报时刻,不是为分层而分层,是当第二个消费端出现时,域服务层已经就位。
模式二:跨存储分页的两种形态
同一个「分页」需求,MySQL 和 Mongo 的写法完全不同,值得放一张对照表:
| 维度 | MySQL(MyBatis-Plus) | MongoDB(MongoTemplate) |
|---|---|---|
| 分页方式 | selectPage(new Page<>(page, pagesize), null) | query.limit(pagesize).skip((page-1)*pagesize) |
| total 统计 | 插件自动发 count 语句 | 手工调 mongoTemplate.count(query, X.class) |
| 排序 | wrapper 上拼 orderBy(传 null 则无排序) | query.with(Sort.by(Sort.Order.desc("created"))) |
| 条件构造 | QueryWrapper.eq/like/lt | Criteria.where("userId").is(uid) |
| 返回封装 | IPage(含 records + total) | 手工组装 PageResult |
要点是 count 必须在加 limit/skip 之前执行,否则统计口径就被分页参数污染了。MovementApiImpl 和 VideoApiImpl 都是先 count 后分页,顺序不能反。
模式三:转 VO 与不转 VO 的不一致
四篇里出现了两种返回风格:视频列表直接把 Video 实体塞进 PageResult 返回;动态列表却先查 UserInfo,再 MovementsVo.init(userInfo, movement) 转成 VO。这是工程里的真实不一致,动态需要展示发布者昵称头像,跨了两个数据源所以必须拼装;视频列表刚好实体字段够用,就偷懒直接返回了。
建议统一处置:对外接口一律转 VO。理由有三个,实体字段变更会直接击穿前端契约、敏感字段没有收敛点、VO 的 init 方法天然是脱敏和格式化的挂载点(AdminVo.init 就是这么做的)。短期内可以接受不一致,但要在代码里留注释标明哪天收敛。
模式四:敏感数据的合规意识
UserInfo 实体里没有 phone 这类强敏感字段,但列表接口吐出了生日、收入、学历、婚姻状态。管理端权限高,运营看到这些没毛病,问题在于没有查看痕迹,谁在什么时候翻了哪个用户的资料,系统一概不知。生产系统对这类后台查询应有审计日志,至少做到「敏感字段单独权限 + 查询行为可追溯」。这也是下一篇内容审核工作隐含的前提:审核员手里的数据,权限边界要清楚。
坑位汇总
四篇踩过的坑浓缩成一张表,收官时过一遍:
| 坑 | 位置 | 处置 |
|---|---|---|
| total 口径 | Mongo 分页 | count 必须在 limit/skip 之前执行 |
| Page 跨 Dubbo 序列化 | UserInfoApi.findAll 返回 IPage | 两端 mf-model 依赖版本必须一致,否则反序列化报错 |
| wrapper 传 null | selectPage(page, null) | 无排序条件,分页结果顺序不稳定,列表页建议显式 orderByDesc("created") |
| uid 可空时 in(null) | VideoApiImpl 的 Criteria.where("userId").in(userId) | uid 为 null 会退化成查全量,需先判空再加条件(MovementApiImpl 就是判空后 is(uid) 的写法) |
| 敏感字段 | 用户列表/详情 | 收敛到 VO + 审计日志 |
| 鉴权实况 | mf-admin 自带 TokenInterceptor 解析 JWT 存 AdminHolder,并非全靠网关过滤器 | 网关做粗粒度拦截,模块内再做一层细粒度解析,两层都要有 |
动手任务
每个任务都给「改哪里、怎么验证」:
keyword 搜索用户列表。改哪里:UserInfoApiImpl.findAll 把第二个参数从 null 换成构造好的 QueryWrapper,用 like("nickname", keyword),Api 接口加 keyword 参数透传。怎么验证:管理后台列表页传昵称关键字,观察发出的 SQL 带 LIKE 且 total 同步变小。
VO 收敛与脱敏。改哪里:ManagerService.findAllUsers 增加 UserInfoVo.init,只暴露昵称/性别/年龄/城市,收入学历进管理员角色才可见的字段集。怎么验证:接口返回 JSON 里不再出现 income 字段。
uid 空校验。改哪里:ManagerController.videos 入口先判 uid == null 直接返回参数错误,别让 in(null) 溜进 Mongo。怎么验证:不传 uid 请求 /manage/videos,应得到 400 而不是全量视频。
查询日志。改哪里:在 TokenInterceptor 取到 Admin 后,把 adminId + URI + 关键参数 + 时间戳 写入独立日志(或 Mongo 审计集合)。怎么验证:查一次用户详情后,日志文件/集合里能看到对应的操作记录。
常见误解澄清
| 误解 | 实情 |
|---|---|
| 管理端也有自己的数据库连接,查自己的表 | mf-admin 只连 mf-admin 库存管理员账号,用户业务数据全部走 Dubbo 拿 |
| 鉴权全靠网关的 AuthFilter,模块内不用管 | 网关只做统一拦截,mf-admin 内部还有自己的 TokenInterceptor 解析 token 填充 AdminHolder |
| 走了 Dubbo 就不用关心分页 count | Mongo 侧的 count 是手写的,漏写 total 恒为 0,前端分页组件直接失效 |
| 直接返回实体最省事,是好实践 | 实体即契约,改一个字段前端就挂;VO 是隔离层,管理端尤其需要 |
总结
用户管理四篇的共性只有一条:管理端是「编排者」不是「实现者」。四个接口、三次 @DubboReference、两种分页形态、一个 VO 拼装,全部复用 C 端域服务,新增一个消费端的成本被分层架构压到了最低。套路带走的优先级:模式一(复用域服务)> 模式二(跨存储分页对照)> 坑位表 > 其余。
至此用户管理系列收官。这里与系列总结衔接,后续进入数据统计与内容审核,动态和视频的审核落地,正好接住这里「查出来的内容」往下做治理。
1533



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



