概述
管理端登录成功后,前端首页要展示管理员的用户名和头像,这就需要一个「查当前登录管理员资料」的接口。这里拆解 mf-admin 里 /system/users/profile 的完整实现,并把 B 端 AdminHolder 与 C 端 UserHolder 的同构设计放在一张表里对照。
纲要
- 业务场景:登录成功 → 前端拿 token → 再调一次 profile 接口渲染首页头像与用户名
- 完整调用链:网关 AuthFilter 校验 token → TokenInterceptor 解析并写入 ThreadLocal → Controller → Service → Mapper
- 核心代码:
SystemController.profile、AdminService.profile、AdminVo - 设计提炼:ThreadLocal 身份传递在 C 端与 B 端的同构复用(对照表)
- 边界与异常:未登录、token 失效、管理员不存在的处理
- 验证方式:带 token / 不带 token 两种请求的实际表现
业务场景
管理端登录是三步:验证码 → 登录拿 token → 用 token 查资料。前两步已实现,剩下最后一步。前端的行为可以抓包看到:登录请求拿到 token 后,紧接着会发第二个请求 profile,请求头里带上 token,服务端返回 AdminVo(含 id、username、avatar),首页据此渲染右上角的头像和用户名。
接口文档约定:
| 项目 | 内容 |
|---|---|
| 请求路径 | /system/users/profile |
| 请求方式 | POST(以工程代码为准,@PostMapping) |
| 请求头 | Authorization: Bearer <token> |
| 返回 | AdminVo(id、username、avatar) |
先看整体时序:
代码实现
mf-admin 模块与本接口相关的结构:
mf-admin/src/main/java/com/mf/admin
├── AdminServerApplication.java
├── controller
│ ├── SystemController.java # profile 接口在这里
│ └── ManagerController.java
├── service
│ ├── AdminService.java # profile 业务逻辑
│ └── ManagerService.java
├── mapper
│ └── AdminMapper.java # MyBatis-Plus BaseMapper
├── interceptor
│ ├── TokenInterceptor.java # 解析 token 写入 ThreadLocal
│ ├── AdminHolder.java # ThreadLocal 工具类
│ └── WebConfig.java # 注册拦截器
└── exception
├── BusinessException.java
└── ExceptionAdvice.java
AdminVo
返回值载体放在 mf-model 模块的 com.mf.model.vo 包下。注意 id 在 VO 里是 String,而实体里是 Long,init 方法里做了一次 toString() 转换,避免前端 JS 处理长整型时精度丢失,这是前后端联调的老坑。
package com.mf.model.vo;
import com.mf.model.domain.Admin;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
@Data
@NoArgsConstructor
@AllArgsConstructor
public class AdminVo {
/**
* id
*/
private String id;
/**
* 用户名
*/
private String username;
/**
* 头像
*/
private String avatar;
public static AdminVo init(Admin admin) {
AdminVo vo = new AdminVo();
vo.setAvatar(admin.getAvatar());
vo.setUsername(admin.getUsername());
vo.setId(admin.getId().toString());
return vo;
}
}
SystemController
实测工程代码,profile 用的是 @PostMapping 而不是直觉上的 GET(同一 Controller 里验证码是 @GetMapping、登录是 @PostMapping)。前端页面照着 POST 发请求即可,别想当然改成 GET 去调试。
package com.mf.admin.controller;
import cn.hutool.captcha.CaptchaUtil;
import cn.hutool.captcha.LineCaptcha;
import com.mf.admin.service.AdminService;
import com.mf.commons.utils.Constants;
import com.mf.model.vo.AdminVo;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.Map;
@RestController
@RequestMapping("/system/users")
public class SystemController {
@Autowired
private AdminService adminService;
@Autowired
private RedisTemplate<String,String> redisTemplate;
//获取验证码图片
@GetMapping("/verification")
public void verification(String uuid, HttpServletResponse response) throws IOException {
//1、生成验证码对象
LineCaptcha captcha = CaptchaUtil.createLineCaptcha(299, 97);
//2、验证码存入Redis
String code = captcha.getCode();
redisTemplate.opsForValue().set(Constants.CAP_CODE+uuid,code);
//3、输出验证码图片
captcha.write(response.getOutputStream());
}
/**
* 用户登录:
*/
@PostMapping("/login")
public ResponseEntity login(@RequestBody Map map) {
Map retMap = adminService.login(map);
return ResponseEntity.ok(retMap);
}
/**
* 获取用户的信息
*/
@PostMapping("/profile")
public ResponseEntity profile() {
AdminVo vo = adminService.profile();
return ResponseEntity.ok(vo);
}
}
(验证码与登录属于前文内容,完整放出来是为了看清三个接口在同一个 Controller 里的排布,这里新增的只有 profile 方法。)
AdminService
业务只有三行:从 AdminHolder 取 id → 查库 → 转 VO。这里查库走的是本模块的 AdminMapper(MyBatis-Plus 的 BaseMapper),Admin 实体就在 mf-model 里,数据源是 mf-admin 自己连的 MySQL,没有走 Dubbo。后文「用户管理」查 C 端用户才用 Dubbo 调 mf-dubbo-service,别混淆。
package com.mf.admin.service;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.mf.admin.exception.BusinessException;
import com.mf.admin.interceptor.AdminHolder;
import com.mf.admin.mapper.AdminMapper;
import com.mf.commons.utils.Constants;
import com.mf.commons.utils.JwtUtils;
import com.mf.model.domain.Admin;
import com.mf.model.vo.AdminVo;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Service;
import org.springframework.util.StringUtils;
import cn.hutool.crypto.SecureUtil;
import java.util.HashMap;
import java.util.Map;
@Service
public class AdminService {
@Autowired
private AdminMapper adminMapper;
@Autowired
private RedisTemplate<String,String> redisTemplate;
//获取当前用户的用户资料
public AdminVo profile() {
Long id = AdminHolder.getId();
Admin admin = adminMapper.selectById(id);
return AdminVo.init(admin);
}
}
为什么 ThreadLocal 里已有 Admin 还要查一次库?
这是本接口最容易产生的疑问。TokenInterceptor 解析 token 后只拿到了 claims 里的 id 和 username,构造的 Admin 对象只有这两个字段:
package com.mf.admin.interceptor;
import com.mf.admin.service.AdminService;
import com.mf.commons.utils.JwtUtils;
import com.mf.model.domain.Admin;
import io.jsonwebtoken.Claims;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
* 自定义拦截器
*/
@Component
public class TokenInterceptor implements HandlerInterceptor {
@Autowired
private AdminService adminService;
/**
* 前置处理
*/
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
//1、获取头信息
String token = request.getHeader("Authorization");
token = token.replace("Bearer ", "");
//2、调用service根据token查询用户
Claims claims = JwtUtils.getClaims(token);
Admin admin = new Admin();
admin.setId(claims.get("id",Long.class));
admin.setUsername(claims.get("username",String.class));
//4、将对象存入Threadlocal
AdminHolder.set(admin);
return true;
}
}
而接口要求返回 avatar(头像),JWT 里没有存,ThreadLocal 里的 Admin 自然也没有。所以必须回库查完整对象再组装 VO。本质原因:token 是身份凭证,不是资料缓存,把头像这类可变数据塞进 token 会导致改了头像 token 里的旧值还在生效。
ThreadLocal 身份传递的同构复用
这里真正的提炼价值在于:C 端 UserHolder(mf-app-server)和 B 端 AdminHolder(mf-admin)是完全同构的设计。同一套「拦截器解析 token → 写 ThreadLocal → 业务层取身份」的模式,在两套体系里各落了一遍地,代码几乎可以互相抄。
| 对照项 | C 端(交友 App) | B 端(管理后台) |
|---|---|---|
| 模块 | mf-app-server | mf-admin |
| 拦截器 | TokenInterceptor | TokenInterceptor(@Component) |
| 解析产物 | User(id、mobile) | Admin(id、username) |
| Holder | UserHolder,ThreadLocal<User> | AdminHolder,ThreadLocal<Admin> |
| JWT payload | id、mobile | id、username |
| 业务取用 | UserHolder.getUserId() | AdminHolder.getId() |
| 登录入口放行 | 注册登录接口 | /system/users/login、/system/users/verification |
| token 校验位置 | 网关 AuthFilter 统一校验 | 网关 AuthFilter 统一校验 |
两个细节值得点出:
- 两边的拦截器都只重写了
preHandle,都没有在afterCompletion里调remove()。Tomcat 线程池会复用线程,理论上存在上一个请求的身份残留到下一个请求的风险。示例代码为了精简省掉了,生产环境建议补上。 - B 端拦截器对 token 失效的处理依赖网关:
AuthFilter里JwtUtils.verifyToken失败直接返回 401,请求根本到不了微服务,所以微服务内的preHandle可以放心解析。
异常与边界
| 场景 | 表现 | 原因 |
|---|---|---|
| 不带 token 请求 profile | 网关返回 401,errMessage: "用户未登录" | AuthFilter 校验失败直接拦截,请求不进入 mf-admin |
| token 过期/被篡改 | 同上 401 | JwtUtils.verifyToken 返回 false |
| TokenInterceptor 中 token 为空 | NPE(token.replace 处空指针) | 拦截器未做空判断,被网关挡住后正常流量触发不到 |
| AdminHolder 中无数据 | getId() 抛 NPE | 只有拦截器被绕过时才会发生,正常链路不可能 |
| 管理员被删但 token 仍有效 | selectById 返回 null → AdminVo.init NPE | 示例代码未判空;严谨做法是判空后抛 BusinessException |
验证
按顺序可复现:
# 1、登录拿 token(验证码接口先取 uuid)
curl -X POST http://localhost:8080/system/users/login \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"123456","verificationCode":"xxxx","uuid":"上一步的uuid"}'
# 2、带 token 调 profile(经网关,端口以网关配置为准)
curl -X POST http://localhost:8080/system/users/profile \
-H "Authorization: Bearer <上一步的token>"
# 预期返回:
# {"id":"1","username":"admin","avatar":"http://...png"}
# 3、不带 token 调 profile
# 预期:网关直接返回 401,errMessage 为"用户未登录",后台无任何日志
实际页面验证更直观:浏览器登录后按 F12,Network 里能看到登录请求返回 token 后紧跟着一个 profile 请求,只带了 token 一个参数,响应即为管理员资料。
常见误解澄清
| 误解 | 实际情况 |
|---|---|
| profile 是 GET 请求 | 工程代码是 @PostMapping,实测为准 |
| 该接口走 Dubbo 远程调用 | 不走,AdminMapper 直连本服务数据库;Dubbo 是后续用户管理章节查 C 端数据才用的 |
| ThreadLocal 里已有 Admin,可直接返回 | ThreadLocal 中的对象只有 id 和 username,缺 avatar,必须回库查 |
| token 校验要写在每个微服务里 | 网关 AuthFilter 统一校验,微服务内拦截器只负责解析身份,不做校验拦截 |
AdminVo.init 是 BeanUtils 拷贝 | 是手写的静态工厂方法,包含 Long→String 的显式转换 |
API 速览
| 接口 | 方法 | 说明 | 鉴权 |
|---|---|---|---|
/system/users/verification | GET | 获取图片验证码 | 免 |
/system/users/login | POST | 登录,返回 token | 免 |
/system/users/profile | POST | 查询当前管理员资料 | 网关校验 token |
总结
管理员登录到此收官:验证码(工具类生成、Redis 存储)、登录(校验验证码与密码、签发 JWT)、查资料(ThreadLocal 取身份、回库补全、转 VO)三步全部就位,页面完成跳转。回头看这个接口的价值不在三行代码本身,而在模式确认,C 端和 B 端用同一套「拦截器 + ThreadLocal + VO 转换」的骨架承载身份传递,看懂一处等于看懂两处。下一站是同章的用户管理:用户管理:分页查询用户列表,那里会第一次通过 Dubbo 跨服务查 C 端数据。
1207



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



