概述
前面已经拿到了图片验证码,这里把登录闭环走完:前端提交用户名、密码、验证码、uuid 四项,服务端校验验证码、比对 MD5 密码、签发 JWT,把 token 交回前端。
纲要
- 登录接口定义:
POST /system/users/login,请求/响应结构 - 涉及文件:SystemController、AdminService、AdminMapper、Admin、JwtUtils、Constants、BusinessException/ExceptionAdvice
- 核心链路三步(AdminService.login):
- 校验图片验证码(Redis
CAP_CODE_+uuid,通过后 delete,用后即删) - MD5 比对密码(
SecureUtil.md5,弱哈希的坑) - 签发 JWT(
JwtUtils.getToken,payload 放 id + username) - 登录后的鉴权衔接:TokenInterceptor → AdminHolder(ThreadLocal)
- 完整时序图、踩坑清单、可复现验证步骤
接口定义
后台登录接口独立于 APP 端,走的是 mf-admin 自己的 Controller。按 YAPI 文档:
| 项目 | 内容 |
|---|---|
| 接口路径 | /system/users/login |
| 请求方式 | POST |
| 请求参数 | JSON body:username、password、verificationCode、uuid |
| 返回值 | JSON:{"token": "..."} |
一个容易记错的点:验证码参数名是 verificationCode,不是 verification,后文实读的代码里取值用的就是 map.get("verificationCode"),和前端页面提交的字段一一对应。
四个参数的来源:username/password 是用户输入,verificationCode 是用户照图片填的验证码,uuid 是获取验证码接口(GET /system/users/verification)时前端生成并拼在 URL 上的唯一标识,Redis 里的验证码就存在 CAP_CODE_+uuid 这个 key 下面。登录时靠它找回对应的那张验证码。
文件清单
| 文件 | 模块 | 职责 |
|---|---|---|
| SystemController | mf-admin | 暴露 POST /system/users/login 接口 |
| AdminService | mf-admin | 登录核心逻辑:验证码校验、密码比对、签发 token |
| AdminMapper | mf-admin | MyBatis-Plus BaseMapper,按用户名查 Admin |
| BusinessException / ExceptionAdvice | mf-admin | 业务异常 + 统一异常处理,错误信息以 {message} 返回 |
| Admin | mf-model | 管理员实体,对应 tb_admin 表 |
| JwtUtils | mf-commons | JWT 签发/解析工具类(与 C 端共用) |
| Constants | mf-commons | CAP_CODE_ 等 Redis key 前缀常量 |
| TokenInterceptor / AdminHolder | mf-admin | 登录后的鉴权衔接(下文简述) |
工程结构(只列登录相关):
mf
├── mf-admin # 后台系统服务
│ └── src/main/java/com/mf/admin
│ ├── controller
│ │ └── SystemController.java # 登录/验证码/用户资料接口
│ ├── service
│ │ └── AdminService.java # 登录核心逻辑
│ ├── mapper
│ │ └── AdminMapper.java # 继承 BaseMapper<Admin>
│ ├── exception
│ │ ├── BusinessException.java # 自定义业务异常
│ │ └── ExceptionAdvice.java # @ControllerAdvice 统一异常处理
│ └── interceptor
│ ├── TokenInterceptor.java # 校验管理员 JWT
│ ├── AdminHolder.java # ThreadLocal 存管理员
│ └── WebConfig.java # 注册拦截器
├── mf-model # 实体与 VO
│ └── src/main/java/com/mf/model
│ └── domain
│ └── Admin.java # 管理员实体
└── mf-commons # 公共工具
└── src/main/java/com/mf/commons
└── utils
├── JwtUtils.java # JWT 工具类(管理员/用户共用)
└── Constants.java # CAP_CODE_ 常量
有个结构上的背景值得交代:后台系统功能少、涉及的表也少,所以 Controller、Service、Mapper 全部放在 mf-admin 一个工程里,没有像 C 端那样拆 dubbo 服务。这也是为什么这里能直接注入 AdminMapper 查库,而不是走远程接口。
代码链路
Controller:登录入口
以下代码实读自 mf-admin/src/main/java/com/mf/admin/controller/SystemController.java:
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,key = CAP_CODE_ + uuid
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) {
//调用service完成登录,返回只含一个token键值对的Map
Map retMap = adminService.login(map);
return ResponseEntity.ok(retMap);
}
/**
* 获取用户的信息(下一篇的内容,登录成功后前端立刻会调它)
*/
@PostMapping("/profile")
public ResponseEntity profile() {
AdminVo vo = adminService.profile();
return ResponseEntity.ok(vo);
}
}
类上有 @RequestMapping("/system/users"),所以登录的完整路径是 POST /system/users/login。
Controller 薄得只有两行:把 @RequestBody 反序列化出来的 Map 原样交给 service,拿回结果包成 200 响应。参数为什么不封装成 DTO?因为四个字段直接 map.get 已经够用,教学项目从简;生产代码还是建议定义 LoginRequest,字段名和类型有编译期保障。
返回值为什么是 Map 而接口文档只写一个 token 字符串?因为前后端分离项目响应体是 JSON,{token: "xxx"} 序列化后就是 {"token":"xxx"},前端按 key 取值。Map 里只有一个键值对而已。
service 抛出的 BusinessException 不在这里处理,统一交给 ExceptionAdvice:
package com.mf.admin.exception;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import java.util.HashMap;
import java.util.Map;
/**
* 统一异常处理
*/
@ControllerAdvice
public class ExceptionAdvice {
@ExceptionHandler(Exception.class)
public ResponseEntity handleExcepting(Exception e) {
e.printStackTrace();
//业务异常返回真实提示,其他异常统一说"服务器内部错误"(不向前端泄露堆栈细节)
String message = "服务器内部错误";
if(e instanceof BusinessException) {
message = ( (BusinessException) e).getMessage();
}
Map map = new HashMap();
map.put("message",message);
return ResponseEntity.status(500).body(map);
}
}
所以前端拿到的响应只有两种形态:200 + {"token":...},或 500 + {"message":"验证码错误"} 这类提示。
AdminService.login:这里核心
实读自 mf-admin/src/main/java/com/mf/admin/service/AdminService.java,整个方法六步:
package com.mf.admin.service;
import cn.hutool.crypto.SecureUtil;
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 java.util.HashMap;
import java.util.Map;
@Service
public class AdminService {
@Autowired
private AdminMapper adminMapper;
@Autowired
private RedisTemplate<String,String> redisTemplate;
public Map login(Map map) {
//1、获取请求参数:用户名、密码、验证码、uuid
String username = (String )map.get("username");
String password = (String )map.get("password");
String verificationCode = (String )map.get("verificationCode");
String uuid = (String )map.get("uuid");
//2、校验验证码:从Redis取出发来的验证码比对
String key = Constants.CAP_CODE + uuid;
String value = redisTemplate.opsForValue().get(key);
if(StringUtils.isEmpty(value) || !verificationCode.equals(value)) {
//取不到(过期/不存在)或不一致,都算验证码错误
throw new BusinessException("验证码错误");
}
//校验通过后立刻删除,用后即删
redisTemplate.delete(key);
//3、根据用户名查询管理员对象
QueryWrapper<Admin> qw = new QueryWrapper<Admin>().eq("username",username);
Admin admin = adminMapper.selectOne(qw);
//4、判断admin是否存在、密码是否一致:入参密码先做MD5再和库里密文比
password = SecureUtil.md5(password);
if(admin == null || !password.equals(admin.getPassword())) {
throw new BusinessException("用户名或者密码错误");
}
//5、生成token:payload放管理员id和用户名
Map tokenMap = new HashMap();
tokenMap.put("id",admin.getId());
tokenMap.put("username",admin.getUsername());
String token = JwtUtils.getToken(tokenMap);
//6、构造返回值:{"token": "..."}
Map retMap = new HashMap();
retMap.put("token",token);
return retMap;
}
//获取当前用户的用户资料(下一篇展开)
public AdminVo profile() {
Long id = AdminHolder.getId();
Admin admin = adminMapper.selectById(id);
return AdminVo.init(admin);
}
}
第一步之后马上是验证码校验,看 delete 的位置
校验逻辑本身不复杂:拼出 CAP_CODE_+uuid,从 Redis 取值,取不到(key 不存在,可能是过期或压根没申请过验证码)或对不上,抛「验证码错误」。
真正值得咀嚼的是 redisTemplate.delete(key) 的位置,它在校验通过之后、查库之前。这个「用后即删」有两层含义:
- 防重放:同一个验证码只能成功登录一次。第二次拿着相同验证码+uuid 来登录,Redis 里已经没有这个 key 了,第一步就会被拦下。如果删在登录失败路径上,攻击者可以拿一个真验证码无限次试密码,图片验证码就形同虚设。
- 失败不删,可重试:用户手滑输错验证码,key 还在 Redis 里,改一下重新提交就行,不用刷新页面换图。这是刻意的体验设计,代价是验证码在有效期内可以错多次(本项目连过期时间都没设,见后文坑表)。
对照前面生成验证码的代码看闭环:生成时 set(Constants.CAP_CODE+uuid, code),登录时 get + 校验通过后 delete。一存一取一删,key 生命周期就结束了。
MD5 比对密码
数据库里的密码存的不是明文。tb_admin 表预置了一条超级管理员数据:用户名 admin,密码是 MD5("123456") 后的密文。所以代码里把用户输入的密码先 SecureUtil.md5() 转成密文,再和库里字段做字符串比较:
password = SecureUtil.md5(password);
if(admin == null || !password.equals(admin.getPassword())) {
throw new BusinessException("用户名或者密码错误");
}
注意 admin == null 和密码不一致共用一个错误提示「用户名或者密码错误」,不能分开提示「用户不存在」/「密码错误」,否则等于帮攻击者枚举有效用户名。这是登录接口的通用做法。
MD5 在这里必须点一句:它是弱哈希,无盐、运算快,彩虹图一场就能反查大部分常见密码,123456 的 MD5(e10adc3949ba59abbe56e057f20f883e)网上随手可查。生产环境应该用 BCrypt 这类专为密码设计的慢哈希(自带随机盐,Spring Security 的 BCryptPasswordEncoder 是现成选择)。项目用 MD5 只是为了演示流程。
签发 JWT
密码校验通过后,用 JwtUtils.getToken 签发 token。这个工具类在 mf-commons 里,和 C 端用户登录用的是同一个类,管理员体系和用户体系是两套独立的鉴权链路,但签名密钥、算法、工具类是共用的。实读 mf-commons/src/main/java/com/mf/commons/utils/JwtUtils.java:
package com.mf.commons.utils;
import io.jsonwebtoken.Claims;
import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.SignatureAlgorithm;
import org.apache.commons.lang3.StringUtils;
import java.util.Date;
import java.util.Map;
public class JwtUtils {
// TOKEN的有效期1小时(S)——注意:注释和实际值不符,实际是7天
private static final int TOKEN_TIME_OUT = 7 * 24 * 3600;
// 加密KEY
private static final String TOKEN_SECRET = "mf";
// 生成Token
public static String getToken(Map params){
long currentTime = System.currentTimeMillis();
return Jwts.builder()
.signWith(SignatureAlgorithm.HS512, TOKEN_SECRET) //HS512对称加密
.setExpiration(new Date(currentTime + TOKEN_TIME_OUT * 1000)) //过期时间戳
.addClaims(params) //自定义payload
.compact();
}
/**
* 获取Token中的claims信息
*/
public static Claims getClaims(String token) {
return Jwts.parser()
.setSigningKey(TOKEN_SECRET)
.parseClaimsJws(token).getBody();
}
/**
* 是否有效 true-有效,false-失效
*/
public static boolean verifyToken(String token) {
if(StringUtils.isEmpty(token)) {
return false;
}
try {
Claims claims = Jwts.parser()
.setSigningKey("mf")
.parseClaimsJws(token)
.getBody();
}catch (Exception e) {
return false;
}
return true;
}
}
login 里只放了两项进 payload:管理员 id 和 username。token 是可逆解码的字符串(Base64 分段),任何拿到 token 的人都能解出 payload,所以视频里反复强调:隐私数据(密码、身份证号)绝对不能往里放,只放后续业务要用到的最小标识。
HS512 是对称签名,密钥 TOKEN_SECRET 写死在代码里,服务端用它签也用它验。密钥泄露 = 任何人可伪造 token,这也是生产上要换非对称或密钥托管的理由。
返回与前端衔接
service 返回 {"token": "..."},Controller 包成 200。前端拿到后存起来,后续每个请求在请求头带上:
Authorization: Bearer <token>
实测浏览器 F12 能看到完整过程:页面点登录会连发两个请求,先是 login 拿 token,紧接着是 profile 用 token 换用户资料。前面只完成了验证码,这里完成后 login 这一环闭环,profile 是后续要展开的主题。
登录后的鉴权衔接
token 发出去之后怎么用?mf-admin 里注册了 TokenInterceptor,对所有需要登录的接口做前置校验:
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、获取请求头并去掉"Bearer "前缀
String token = request.getHeader("Authorization");
token = token.replace("Bearer ", "");
//2、解析token,重建Admin对象
Claims claims = JwtUtils.getClaims(token);
Admin admin = new Admin();
admin.setId(claims.get("id",Long.class));
admin.setUsername(claims.get("username",String.class));
//3、存入ThreadLocal,后续业务直接取
AdminHolder.set(admin);
return true;
}
}
AdminHolder 是标准的 ThreadLocal 封装:
package com.mf.admin.interceptor;
import com.mf.model.domain.Admin;
/**
* 通过ThreadLocal的形式,存储管理员的数据
*/
public class AdminHolder {
private static ThreadLocal<Admin> admins = new ThreadLocal<>();
//向当前线程存储数据
public static void set(Admin admin) {
admins.set(admin);
}
//从当前线程获取数据
public static Admin getAdmin() {
return admins.get();
}
public static void remove() {
admins.remove();
}
//获取当前管理员的id
public static Long getId() {
return admins.get().getId();
}
}
串起来就是:登录签发 token → 后续请求携带 → TokenInterceptor 解析出 id/username → 存入 AdminHolder(ThreadLocal)→ 同线程内的 Service 随处 AdminHolder.getId(),比如 profile() 第一行就是这么取当前管理员的。
对照 C 端:那边是 TokenInterceptor + UserHolder,这边是同款 JwtUtils + AdminHolder。两套体系独立,token 里的字段、拦截器注册的工程、Holder 的类型都不一样,C 端 token 进不了后台,后台 token 也调不了 C 端接口。工具类共用只是省代码,鉴权边界并没混。
时序图
踩坑清单
| 坑 | 本项目的表现 | 后果与正确姿势 |
|---|---|---|
| 验证码校验后未删 | 已规避:delete(key) 在校验通过后立即执行 | 不删则同一验证码可反复登录,防机器人的意义归零;删除动作必须放在通过分支,失败不删(保住重试体验) |
| MD5 无盐 | SecureUtil.md5(password),纯 MD5 无盐 | 彩虹表可反查;生产用 BCrypt/Argon2,BCryptPasswordEncoder 自带盐 |
| 登录接口未限流 | 没有 IP/账号维度的限流或失败锁定 | 图片验证码成了唯一防线,脚本仍可低成本刷验证码爆破;生产要加速度限制 + 失败 N 次锁定/延时 |
| JWT payload 放敏感信息 | 只放了 id 和 username,是克制的 | token 可被任何人 Base64 解码,放密码/手机号等于泄露;坚持「最小 payload」 |
| 登录失败不锁定 | 错多少次都只是提示错误 | 配合上一条,暴力破解防护缺位 |
| 验证码 key 未设过期时间 | set 时没调 expire | 验证码永不过期(重启前一直有效),变相拉长重放窗口;应 set(key, code, 5, TimeUnit.MINUTES) |
| 拦截器未用 verifyToken | TokenInterceptor 直接 getClaims | token 过期/伪造时抛异常走 500「服务器内部错误」,而不是 401 引导重新登录;应先 verifyToken 再取值 |
| ThreadLocal 用完不清理 | AdminHolder.remove() 定义了但没在 afterCompletion 调用 | Tomcat 线程复用,可能串到下一次请求的数据(本次项目 Admin 每次都被覆盖,风险被掩盖);规范做法是拦截器 afterCompletion 里 remove |
验证:可复现步骤
前提:mf-admin 已启动,Redis、MySQL、Nacos 就绪,tb_admin 表里有预置的 admin 账号。
-
获取验证码。浏览器打开登录页,前端自动请求
GET /system/users/verification?uuid=xxxx,页面渲染出图片验证码,同时记住这次请求的 uuid(F12 Network 里能看到)。 -
redis-cli 确认验证码已入库:
redis-cli > keys CAP_CODE_* 1) "CAP_CODE_9f8b7c6d-1234-5678-9abc-def012345678" > get CAP_CODE_9f8b7c6d-1234-5678-9abc-def012345678 "d76zp" -
登录(带验证码 + uuid):
curl -X POST http://localhost:18080/system/users/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"123456","verificationCode":"d76zp","uuid":"9f8b7c6d-1234-5678-9abc-def012345678"}'
正常响应:{"token":"eyJhbGciOiJIUzUxMiJ9..."}
-
用 token 调 profile 验证:
curl -X POST http://localhost:18080/system/users/profile \ -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..."
返回 AdminVo(含 id、username、avatar)说明 token 有效、拦截器链路通。
-
验证「用后即删」。拿同一个验证码和 uuid 再发一次登录请求:
curl -X POST http://localhost:18080/system/users/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"123456","verificationCode":"d76zp","uuid":"9f8b7c6d-1234-5678-9abc-def012345678"}'
响应变为 {"message":"验证码错误"},Redis 里 key 已删,第二次必失败。防重放生效。
常见误解澄清
| 误解 | 事实 |
|---|---|
登录接口路径是 /login | 类上有 @RequestMapping("/system/users"),完整路径是 POST /system/users/login |
验证码参数叫 verification | 工程实读参数名是 verificationCode,与前端提交字段一致 |
service 校验失败时返回 ResponseEntity.status(500) | 工程版 service 统一抛 BusinessException,由 ExceptionAdvice 统一转成 500 + {message}(讲义里的早期版本是手工构造 500 响应,且那段代码还有 map.put 写错变量的小 bug,以工程实读为准) |
| token 是不可逆的加密串 | JWT 只是签名防篡改,payload 段 Base64 即可解出,属于「可读不可改」 |
| 管理员 JWT 和 C 端用户 JWT 互通 | 不互通。两套独立体系:各自实体、各自拦截器、各自 Holder;只是共用同一个 JwtUtils 工具类和签名密钥 |
| 密码比对是拿明文比 | 先 SecureUtil.md5() 转密文再比;库里存的一直是密文 |
| 删除验证码是登出逻辑 | delete 发生在登录成功瞬间,属于验证码防重放设计,和登出无关 |
官方文档
- JWT 官网(RFC 7519 介绍)
- jjwt GitHub(本项目使用的 io.jsonwebtoken)
- Hutool SecureUtil(MD5 工具)
- OWASP 认证速查表(登录安全最佳实践)
- Spring Security BCryptPasswordEncoder
总结
- 登录接口
POST /system/users/login,四参数 username/password/verificationCode/uuid,Controller 只做转发,逻辑全在AdminService.login。 - 核心三步:验证码校验(Redis
CAP_CODE_+uuid,通过即 delete,防重放且失败可重试)→ MD5 密文比对(共用错误提示防用户枚举,但 MD5 本身弱,生产换 BCrypt)→JwtUtils.getToken({id, username})签发。 - 响应体是
{"token": "..."},前端保存后每次请求带Authorization: Bearer <token>,TokenInterceptor解析后存入AdminHolder(ThreadLocal)供业务取用,与 C 端UserHolder结构同款但体系独立。 - 安全短板要心里有数:无过期时间、无限流、无失败锁定、MD5 无盐,工程项目重流程演示,生产环境每一条都要补。
后续继续同章管理员登录:查询用户资料:profile 接口如何从 AdminHolder 取出当前管理员、AdminVo 如何组装返回。
2565



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



