概述
运营在后台用户列表里点一行「查看」,进入该用户的详情页,这里实现支撑这个页面的接口:根据路径参数中的用户 ID,经 Dubbo 调用 mf-dubbo 服务查出 UserInfo 返回,并把详情页「资料 + 动态记录 + 视频记录」的聚合方式讲透。
纲要
- 业务场景:从用户列表到用户详情页
- 详情页长什么样(原型线框)
- 与 C 端「查看自己的资料」的区别
- 接口设计:
GET /manage/users/{userId} - 请求 / 返回定义、JSON 示例
- 代码链路(实读 mf-admin 工程)
ManagerController.findUserByIdManagerService.findUserById→@DubboReference UserInfoApi.findById- 返回值为什么是
UserInfo而不是 VO - 聚合查询设计(这里深挖点)
- 实读结论:详情接口是单点查询,画像由前端多次请求拼装
- 后端聚合的改进思路:串行 vs 并行(
CompletableFuture) - 多数据源的一致性:接受最终一致
- 完整调用时序(Mermaid)
- 异常与边界:用户不存在、部分聚合失败、越权
- 验证要点
- 常见误解澄清
业务场景:从用户列表到用户详情页
在用户管理:分页查询用户列表里,GET /manage/users 返回了 PageResult,前端渲染出用户列表表格。列表里每行只放得下昵称、头像、性别这几个关键列,运营要判断「这个用户值不值得封号、资料全不全」,必须看完整画像。于是列表每行带一个「查看」按钮,点击后跳转详情页,携带该行的用户 ID。
详情页的数据分三块:
- 基本资料(本节实现):昵称、头像、年龄、城市、学历、收入、职业、婚姻状态、标签等,来自 MySQL 的
tb_user_info表,走UserInfoApi.findById; - 动态记录列表:该用户发过的所有动态,走
/manage/messages; - 视频记录列表:该用户发过的所有视频,走
/manage/videos。
页面刚打开时的请求顺序是:先调详情接口渲染顶部资料,再并发调动态、视频两个列表接口填充下方表格。本文讲完时,后两个接口还没实现,所以详情页下方两个表格区是报错状态,这是预期中的中间态,后续章节补齐。
原型线框
+------------------------------------------------------------------+
| 交友项目后台管理系统 [运营人员:admin] [退出] |
+------------------------------------------------------------------+
| 用户管理 > 用户详情 |
+------------------------------------------------------------------+
| |
| (头像) 昵称:某某某 性别:女 |
| 年龄:25 城市:上海 |
| 学历:本科 收入:20k以上 |
| 职业:设计师 婚姻状态:未婚 |
| 标签:#旅行 #美食 #摄影 |
| |
+------------------------------------------------------------------+
| 动态记录列表 [分页: 1 2 3 >] |
| +------------------------------------------------------------+ |
| | 动态ID | 发布时间 | 内容摘要 | 状态 | 操作 | |
| | 1001 | 09-01 | 今天天气不错... | 已通过 | [查看] | |
| | 1002 | 09-03 | 周末去爬山... | 待审核 | [查看] | |
| +------------------------------------------------------------+ |
+------------------------------------------------------------------+
| 视频记录列表 [分页: 1 2 3 >] |
| +------------------------------------------------------------+ |
| | 视频ID | 发布时间 | 封面预览 | 状态 | 操作 | |
| | 2001 | 09-02 | [缩略图] | 已通过 | [播放] | |
| +------------------------------------------------------------+ |
+------------------------------------------------------------------+
要点:
- 顶部资料区与下方两个列表区是三个独立接口供的数据,不是一个大 JSON;
- 两个列表区各自带独立分页,资料区不分页;
- 本文交付顶部资料区接口,两个列表接口在查看用户视频记录列表等后续章节交付。### 与 C 端「查看自己的资料」的区别
项目 APP 端也有「查看资料」,但管理端这次不是简单复用:
| 维度 | C 端查看资料 | 管理端查看用户详情 |
|---|---|---|
| 查谁 | 只能查自己(token 解析出 userId) | 查任意用户(路径参数传入 userId) |
| 入口 | 个人中心,Token 拦截器取当前用户 | 用户列表行「查看」按钮 |
| 鉴权 | APP 端 TokenInterceptor | 管理端 TokenInterceptor(JWT 中的 admin 身份) |
| 数据范围 | 自己的 UserInfo | 任意用户的 UserInfo + 动态/视频记录 |
| 调用链 | mf-app-server → Dubbo | mf-admin → Dubbo |
关键差异是目标用户的来源:C 端的 userId 从 JWT 里解析出来(自己查自己),管理端的 userId 从 URL 路径里取(查别人)。所以管理端接口天然要处理「这个 ID 可能不存在」的问题,而 C 端几乎不用。
接口设计
| 项目 | 内容 |
|---|---|
| 接口地址 | /manage/users/{userId} |
| 请求方式 | GET |
| 路径参数 | userId:要查看的用户 ID(Long) |
| 请求头 | Authorization: Bearer <admin token> |
| 返回值 | UserInfo(注意:不是 UserInfoVO) |
| 成功响应 | 200,body 为 UserInfo 的 JSON |
| 用户不存在 | 200 + 空 body,或业务异常(取决于调用方处理,见异常与边界) |
返回 JSON 示例:
{
"id": 1,
"nickname": "user_1001",
"avatar": "https://mf-static.oss-cn-shanghai.aliyuncs.com/avatar/1.jpg",
"birthday": "1998-06-15",
"gender": "woman",
"age": 25,
"city": "上海",
"income": "20k以上",
"education": "本科",
"profession": "设计师",
"marriage": 0,
"tags": "旅行,美食,摄影",
"coverPic": "https://mf-static.oss-cn-shanghai.aliyuncs.com/cover/1.jpg"
}
代码链路
实读 mf-admin 工程,涉及三处代码,链路极短:
mf-admin
└── src/main/java/com/mf/admin
├── controller
│ └── ManagerController.java # GET /manage/users/{userId}
├── service
│ └── ManagerService.java # findUserById → Dubbo
└── interceptor
├── TokenInterceptor.java # JWT 校验,AdminHolder 存当前管理员
└── AdminHolder.java # ThreadLocal<Admin>
Dubbo 侧的接口与实现属于 mf-dubbo-interface / mf-dubbo-db 模块:
mf-dubbo
├── mf-dubbo-interface
│ └── src/main/java/com/mf/dubbo/api
│ └── UserInfoApi.java # UserInfo findById(Long id);
└── mf-dubbo-db
└── src/main/java/com/mf/dubbo/db
└── UserInfoApiImpl.java # userInfoMapper.selectById(id)
ManagerController
package com.mf.admin.controller;
import com.mf.admin.service.ManagerService;
import com.mf.model.domain.UserInfo;
import com.mf.model.vo.PageResult;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/manage")
public class ManagerController {
@Autowired
private ManagerService managerService;
@GetMapping("/users")
public ResponseEntity users(@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer pagesize) {
PageResult result = managerService.findAllUsers(page,pagesize);
return ResponseEntity.ok(result);
}
//根据id查询
@GetMapping("/users/{userId}")
public ResponseEntity findUserById(@PathVariable("userId") Long userId) {
UserInfo userInfo = managerService.findUserById(userId);
return ResponseEntity.ok(userInfo);
}
/**
* 查询指定用户发布的所有视频列表
*/
@GetMapping("/videos")
public ResponseEntity videos(@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer pagesize,
Long uid ) {
PageResult result = managerService.findAllVideos(page,pagesize,uid);
return ResponseEntity.ok(result);
}
//查询动态
@GetMapping("/messages")
public ResponseEntity messages(@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer pagesize,
Long uid,Integer state) {
PageResult result = managerService.findAllMovements(page,pagesize,uid,state);
return ResponseEntity.ok(result);
}
}
三个要点:
@GetMapping("/users/{userId}")与列表接口/manage/users共用/users前缀,靠路径参数区分。Spring MVC 能正确路由:/manage/users走列表,/manage/users/1走详情;- 路径参数用
@PathVariable("userId")接收,类型Long,用户 ID 在全链路统一为 Long,避免 JS 精度问题应在 JSON 序列化时转字符串(工程用 Jackson 全局配置处理); - 直接返回
UserInfo,包一层ResponseEntity.ok()。
ManagerService
package com.mf.admin.service;
import cn.hutool.core.collection.CollUtil;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.mf.dubbo.api.MovementApi;
import com.mf.dubbo.api.UserInfoApi;
import com.mf.dubbo.api.VideoApi;
import com.mf.model.domain.UserInfo;
import com.mf.model.mongo.Movement;
import com.mf.model.vo.MovementsVo;
import com.mf.model.vo.PageResult;
import org.apache.dubbo.config.annotation.DubboReference;
import org.springframework.stereotype.Service;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
@Service
public class ManagerService {
@DubboReference
private UserInfoApi userInfoApi;
@DubboReference
private VideoApi videoApi;
@DubboReference
private MovementApi movementApi;
public PageResult findAllUsers(Integer page, Integer pagesize) {
IPage iPage = userInfoApi.findAll(page, pagesize);
return new PageResult(page, pagesize, iPage.getTotal(), iPage.getRecords());
}
//根据id查询
public UserInfo findUserById(Long userId) {
return userInfoApi.findById(userId);
}
//查询指定用户发布的所有视频列表
public PageResult findAllVideos(Integer page, Integer pagesize, Long uid) {
return videoApi.findByUserId(page, pagesize, uid);
}
//查询动态
public PageResult findAllMovements(Integer page, Integer pagesize, Long uid, Integer state) {
//1、调用API查询数据 :Movement对象
PageResult result = movementApi.findByUserId(uid,state,page,pagesize);
//2、解析PageResult,获取Movement对象列表
List<Movement> items = (List<Movement>) result.getItems();
//3、一个Movement对象转化为一个Vo
if(CollUtil.isEmpty(items)) {
return new PageResult();
}
List<Long> userIds = CollUtil.getFieldValues(items, "userId", Long.class);
Map<Long, UserInfo> map = userInfoApi.findByIds(userIds, null);
List<MovementsVo> vos = new ArrayList<>();
for (Movement movement : items) {
UserInfo userInfo = map.get(movement.getUserId());
if(userInfo != null) {
MovementsVo vo = MovementsVo.init(userInfo, movement);
vos.add(vo);
}
}
//4、构造返回值
result.setItems(vos);
return result;
}
}
详情方法只有一行:userInfoApi.findById(userId)。三个 @DubboReference 中本方法只用到 UserInfoApi,VideoApi、MovementApi 是下方两个列表方法(视频列表直接透传 Dubbo 返回的 PageResult;动态列表还要把 Movement 转成 MovementsVo,顺带用 findByIds 批量补用户资料,这是后面章节的内容)。
UserInfoApi 接口与实现
package com.mf.dubbo.api;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.mf.model.domain.UserInfo;
import java.util.List;
import java.util.Map;
public interface UserInfoApi {
public void save(UserInfo userInfo);
public void update(UserInfo userInfo);
//根据id查询
UserInfo findById(Long id);
/**
* 批量查询用户详情
* 返回值:Map<id,UserInfo>
*/
Map<Long,UserInfo> findByIds(List<Long> userIds,UserInfo info);
//分页查询
IPage findAll(Integer page,Integer pagesize);
}
实现侧(mf-dubbo-db 模块)就是 MyBatis-Plus 的标准主键查询:
@Override
public UserInfo findById(Long id) {
return userInfoMapper.selectById(id);
}
UserInfo 域对象是整个返回体的全部内容,主键策略是 IdType.INPUT,因为 tb_user_info 与 tb_user 一对一,userInfo.id 直接复用 user.id,不是自增生成的:
package com.mf.model.domain;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
import java.util.Date;
@Data
@NoArgsConstructor
@AllArgsConstructor
public class UserInfo implements Serializable {
/**
* 由于userinfo表和user表之间是一对一关系
* userInfo的id来源于user表的id
*/
@TableId(type= IdType.INPUT)
private Long id; //用户id
private String nickname; //昵称
private String avatar; //用户头像
private String birthday; //生日
private String gender; //性别
private Integer age; //年龄
private String city; //城市
private String income; //收入
private String education; //学历
private String profession; //行业
private Integer marriage; //婚姻状态
private String tags; //用户标签:多个用逗号分隔
private String coverPic; // 封面图片
private Date created;
private Date updated;
}
为什么返回 UserInfo 而不是 VO
C 端接口几乎都有对应的 VO(如 UserInfoVo),用来裁剪字段、控制序列化格式。管理端这次直接把 UserInfo 实体丢给了前端,原因很直接:运营后台需要的字段恰好就是实体的全部字段,没有「隐藏敏感字段」的诉求,为它单独建一个字段完全一样的 VO 属于纯模板代码。这也是项目里管理端和 C 端的明显分野,C 端对外输出收敛到 VO,管理端图省事实体直出。
工程代价是耦合:实体字段一改,前端契约跟着变。如果团队后续要给 UserInfo 加内部字段(如审核备注),管理端接口会被动把内部字段暴露给前端,到那时再收敛成 AdminUserDetailVo 也不迟。
聚合查询设计:详情页的「完整画像」怎么来的
先给实读结论:本文的详情接口本身不聚合。GET /manage/users/{userId} 只查 MySQL 里的 UserInfo,一次 Dubbo 调用,串行、单点。详情页下方的动态记录、视频记录,由前端在页面加载时再发两个独立请求(/manage/messages、/manage/videos)各自取数。也就是说「聚合」发生在浏览器端,不是服务端。
这个选择有它的道理:
| 维度 | 前端拼装(工程实际) | 后端聚合(备选) |
|---|---|---|
| 接口职责 | 每个接口单一职责,复用性好 | 一个大接口,只有详情页用得上 |
| 请求次数 | 页面首屏 3 次请求 | 1 次请求 |
| 首屏速度 | 资料先渲染,列表稍后填充,可接受 | 全部到齐才渲染 |
| 分页 | 动态/视频各自独立分页,天然支持 | 一个接口塞三个分页对象,参数爆炸 |
| 耦合 | 页面知道要调哪几个接口 | 页面只调一个接口 |
三个数据块里有两个都要独立分页,这是放弃后端聚合的决定性因素,硬塞进一个接口,返回结构会变成 {userInfo, movementPage, videoPage},请求参数得带三组 page/pagesize,前后端都难受。列表类数据和详情类数据生命周期、缓存策略都不同,拆开是更自然的设计。
如果非要后端聚合:串行 vs 并行
假设产品要求「打开详情页一次请求拿全」(比如要导出完整画像报表),聚合就落到后端。最朴素的写法是串行调三次 Dubbo:
package com.mf.admin.service;
import com.mf.dubbo.api.MovementApi;
import com.mf.dubbo.api.UserInfoApi;
import com.mf.dubbo.api.VideoApi;
import com.mf.model.vo.PageResult;
import org.apache.dubbo.config.annotation.DubboReference;
import org.springframework.stereotype.Service;
import java.util.HashMap;
import java.util.Map;
@Service
public class UserDetailAggregateService {
@DubboReference
private UserInfoApi userInfoApi;
@DubboReference
private VideoApi videoApi;
@DubboReference
private MovementApi movementApi;
/**
* 串行聚合:三次 RPC 耗时叠加,T = T1 + T2 + T3
*/
public Map<String, Object> findUserDetailSerial(Long userId) {
Map<String, Object> detail = new HashMap<>();
detail.put("userInfo", userInfoApi.findById(userId));
PageResult movements = movementApi.findByUserId(userId, null, 1, 10);
PageResult videos = videoApi.findByUserId(1, 10, userId);
detail.put("movements", movements);
detail.put("videos", videos);
return detail;
}
}
串行的问题很直白:三次 RPC 耗时叠加。假设每次调用 50ms,串行 150ms,P99 场景可能叠到几百毫秒。三个调用之间没有数据依赖(动态和视频都只依赖 userId,不依赖彼此的返回),完全可以并行:
package com.mf.admin.service;
import com.mf.dubbo.api.MovementApi;
import com.mf.dubbo.api.UserInfoApi;
import com.mf.dubbo.api.VideoApi;
import com.mf.model.vo.PageResult;
import org.apache.dubbo.config.annotation.DubboReference;
import org.springframework.stereotype.Service;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.TimeUnit;
@Service
public class UserDetailAggregateService {
@DubboReference
private UserInfoApi userInfoApi;
@DubboReference
private VideoApi videoApi;
@DubboReference
private MovementApi movementApi;
/**
* 并行聚合:三次 RPC 同时发起,T = max(T1, T2, T3)
* 统计类数据失败时降级为 null,资料失败时才整体报错
*/
public Map<String, Object> findUserDetailParallel(Long userId) {
// 资料:核心数据,失败直接抛异常
CompletableFuture<Map<String, Object>> userFuture =
CompletableFuture.supplyAsync(() -> {
Map<String, Object> m = new HashMap<>();
m.put("userInfo", userInfoApi.findById(userId));
return m;
});
// 动态统计:非核心,失败降级
CompletableFuture<PageResult> movementFuture =
CompletableFuture.supplyAsync(
() -> movementApi.findByUserId(userId, null, 1, 10));
// 视频统计:非核心,失败降级
CompletableFuture<PageResult> videoFuture =
CompletableFuture.supplyAsync(
() -> videoApi.findByUserId(1, 10, userId));
try {
Map<String, Object> detail = userFuture.get(3, TimeUnit.SECONDS);
// 统计类数据拿不到就置空,页面显示"暂无数据"
detail.put("movements", joinQuietly(movementFuture));
detail.put("videos", joinQuietly(videoFuture));
return detail;
} catch (Exception e) {
throw new RuntimeException("查询用户详情失败, userId=" + userId, e);
}
}
private PageResult joinQuietly(CompletableFuture<PageResult> future) {
try {
return future.get(3, TimeUnit.SECONDS);
} catch (Exception e) {
return new PageResult(); // 降级:空分页对象,前端渲染为空列表
}
}
}
并行化后总耗时从加法变成取最大值。落地时的取舍是核心与非核心分级:资料查不到,详情页没意义,抛异常;统计数查不到,页面显示空表格即可,不该让整个请求 500。
各数据源的一致性:接受最终一致
详情页画像涉及三个存储:用户资料在 MySQL,动态在 MongoDB,视频可能还要关联 OSS 里的文件。这些数据没有任何事务保证,可能出现:
- 用户刚删了 3 条动态,详情页缓存的「动态数」还是旧值;
- 视频文件已从 OSS 删除,数据库记录还在。
管理端场景下这不是 bug。运营看详情页的目的是人工决策(该不该封号、内容有没有违规),统计数字差个位数不影响决策;为追求数据一致强上分布式事务,反而把简单的查询链路拖进复杂度泥潭。合理的做法是:标注数据生成时间(响应里带上 updated),让运营知道看到的是哪一刻的快照;对精确性有要求的场景(如封号前取证),让运营点进具体列表页核对明细,列表接口每次实时查询,天然是最新值。
完整调用时序
鉴权这一环要说明白:TokenInterceptor 在 preHandle 里解析 Authorization 头的 JWT,取出 id、username 构造 Admin 对象放进 AdminHolder(ThreadLocal)。详情接口本身不读 AdminHolder,但所有 /manage/** 请求都过这个拦截器,没有合法 token 的请求在进 Controller 之前就被拦下,这是「越权」边界的第一道防线。
异常与边界
| 场景 | 实际行为 | 处理建议 |
|---|---|---|
userId 不存在(如手动改 URL 传 999999) | selectById 返回 null,接口 200 + 空 body | 前端判空渲染「用户不存在」;严谨做法是 Service 判空后抛 BusinessException,由 ExceptionAdvice 统一转错误响应 |
| userId 格式非法(字母、超长数字) | Spring 类型转换失败,抛 MethodArgumentTypeMismatchException | 全局异常处理器兜底,返回 400 |
| JWT 缺失或伪造 | JwtUtils.getClaims 抛异常,请求 500 | 拦截器捕获后返回 401,前端跳转登录页 |
| Dubbo 调用超时/提供者宕机 | @DubboReference 抛 RPCException | 默认快速失败返回 500;聚合场景下统计类调用可降级为空(见上文并行聚合代码) |
| 部分聚合失败(资料成功、统计失败) | 本节未聚合,不存在此场景;后端聚合改造时需明确取舍 | 核心(资料)失败则整体失败;非核心(统计)失败降级为空 |
| 查别人数据算不算越权 | 管理端本来就看任意用户,路径传 ID 是设计使然 | 真正的越权防线在登录态:TokenInterceptor 保证只有后台管理员能进 /manage/** |
关于「用户不存在返回什么」,项目里没有强校验,ResponseEntity.ok(null) 序列化后就是空 body。管理后台工具属性强,前端判空即可;但如果这个接口未来要开放给其他系统调用,建议补上业务异常,空 body 和「出错了」是两种语义,调用方分不清。
验证要点
- 造数:确认
mf-admin依赖的注册中心、mf-dubbo-db服务已启动,MySQLtb_user_info表里有数据(C 端注册过的用户才有 UserInfo 记录); - 详情核对:浏览器打开用户列表,点第一行「查看」,核对顶部资料区与列表页该行的昵称、头像一致,且年龄、城市、标签等列表页没有的字段都渲染出来了;
- 预期中的报错:页面下方动态、视频两个列表区报错属正常,对应接口尚未实现,后续章节补齐;
- 不存在用户:直接在地址栏访问
/manage/users/999999,确认返回 200 空 body,页面表现为「用户不存在」而不是崩溃; - 未登录:清掉 token 再访问,确认被拦截器挡在 Controller 之外。
常见误解澄清
| 误解 | 实际情况 |
|---|---|
详情接口返回 UserInfoVO | 返回的是 UserInfo 实体。讲解原话特意强调「不是 UserInfoVO 而是 UserInfo」,管理端没有字段裁剪诉求 |
| 详情接口一次返回资料 + 动态数 + 视频数 | 只返回 UserInfo。动态/视频记录由前端调另外两个接口取,「聚合」发生在浏览器端 |
接口路径是 /manage/user/detail?id=1 | 实际是 GET /manage/users/{userId},REST 风格路径参数,与列表接口 /manage/users 同前缀 |
| 查询不存在的用户会报 404 | 实际返回 200 + 空 body,前端需要自己判空 |
| 聚合查询必须用分布式事务保证一致 | 管理端画像查询接受最终一致,统计数与明细列表可能短暂不同步,不影响运营决策 |
| 串行三次 RPC 是必须的 | 若真需要后端聚合,三次调用无数据依赖,CompletableFuture 并行化后耗时从求和变取最大值 |
官方文档
- Apache Dubbo 官方文档(@DubboReference / 超时与集群容错)
- Spring MVC @PathVariable 用法
- MyBatis-Plus CRUD 接口(selectById)
总结
- 管理端详情接口
GET /manage/users/{userId}是全项目最短的一条链路:Controller 取路径参数 → Service 一行 Dubbo 调用 →UserInfoApi.findById主键查询,返回值是UserInfo实体而非 VO; - 详情页的「完整画像」不是后端聚合出来的:资料、动态、视频三个数据块由前端发三个请求拼装,因为其中两个要独立分页,硬合进一个接口参数会爆炸;
- 若未来要做后端聚合,核心取舍有两条:无依赖的多次 RPC 用
CompletableFuture并行化,耗时从叠加变取最大;核心数据(资料)失败整体报错,非核心数据(统计)失败降级为空; - 多存储聚合查询的一致性靠「接受最终一致」化解:管理端是人工决策场景,响应里带上数据时间戳,需要精确值时让运营点进明细列表页核对。
下一篇用户管理:查看用户视频记录列表补齐详情页报错的第一个列表区:按 uid 分页查询指定用户的视频记录,接口 GET /manage/videos 的后端实现。
1533



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



