概述
在完成 mf-admin 的环境搭建和 admin/123456 这个预置账号准备之后,本文回答一个问题:管理员从打开登录页到跳进主页,中间到底发生了什么。结论先行,一次「登录」其实是三次 HTTP 请求,这里把这三步的流程和设计依据讲透,各接口的代码实现分别留给后续三篇文章。
纲要
- B 端登录与 C 端登录的差异(凭证、附加校验、账号来源、安全要求)
- 完整登录流程:获取验证码 → 登录取 token → 取资料进主页(Mermaid 时序图)
- uuid 与 Redis key 的绑定关系:
CAP_CODE_+ uuid - 关键设计点:为什么必须加图片验证码、验证码用后即删、MD5 密码比对、JWT 双体系
- 接口速览与异常边界
- 验证要点与常见误解澄清
B 端登录和 C 端登录差在哪
交友项目的 C 端登录是手机号 + 短信验证码,新用户顺手就注册了。管理后台完全是另一套逻辑,把两套放在一起对比,差异一目了然:
| 维度 | C 端(App 用户) | B 端(管理员) |
|---|---|---|
| 凭证 | 手机号 + 短信验证码 | 用户名 + 密码 + 图片验证码 |
| 附加校验 | 无图形验证码(短信通道本身有频控) | 必须先取图片验证码 |
| 账号来源 | 首次登录自动注册,写入 tb_user | 预置或后台创建,写在 tb_admin 表 |
| 账号量级 | 百万级用户 | 个位数到几十个运营人员 |
| 登录后身份 | UserHolder(ThreadLocal 存 UserInfo) | AdminHolder(ThreadLocal 存 Admin) |
| 安全要求 | 一般 | 更高:一个管理员能冻结任何用户、看所有数据 |
两条线索值得留意。其一,C 端用短信验证码登录,运营商通道和后端都天然带了发送频率限制,攻击者很难高频尝试;B 端是纯账号密码,服务端如果裸奔,爆破脚本可以直接对 /system/users/login 无限试错,所以图片验证码在 B 端不是锦上添花,是必需品。其二,B 端权限远高于 C 端,本文为聚焦主线不做 RBAC 权限模型,但「管理员账号必须更难被冒用」这个前提贯穿了整篇的设计。
账号体系在《后台管理系统:概述与搭建后台环境》一文中已经交代过:tb_admin 表里只有一条预置数据 admin,密码存的是 MD5("123456")。
完整登录流程:一次登录,三次请求
前后端分离项目里,「登录」从来不是一次请求的事。管理后台的完整时序如下:
三步各自的职责划分很清楚:
- 获取验证码图片。进入登录页时前端先自己生成一个 uuid,随后请求服务端;服务端生成验证码图片,把验证码文本存进 Redis(key 为
CAP_CODE_+ uuid),图片以流的形式响应给页面。响应的是一张图片,不是 JSON,前端直接把响应体塞进<img>展示。 - 用户登录换取 token。携带用户名、密码、验证码和那个 uuid 提交;服务端先用 uuid 从 Redis 取出验证码比对,通过后删掉 key,再比对 MD5 后的密码,全部通过则签发 JWT 返回。
- 根据 token 获取管理员资料。前端拿到 token 只代表「凭证合法」,页面上要显示管理员昵称头像,还得拿 token 再请求一次资料接口;服务端解析 token 得到 id 和 username,查库返回 AdminVo。三步走完,页面才跳转主页。
为什么 token 里已经有了 id 和 username,第三步还要查一次库?token 载荷在签发时就固定了,头像这类可能变化的字段不应该塞进 token;而且登录接口刻意只返回 token,不掺业务数据,接口职责更单一。
uuid 是整条链路的「会话粘合剂」
HTTP 请求之间没有状态,「用户看到的验证码」和「Redis 里存的验证码」要靠 uuid 对上号:前端生成 uuid → 带着它请求验证码 → 服务端以 uuid 为 key 存验证码 → 登录时前端再把同一个 uuid 传回来 → 服务端按 key 取值比对。只要页面不刷新,这个 uuid 一直复用;页面一刷新,重新生成 uuid、重新取验证码,旧的 key 就成了孤儿数据(这也是为什么存验证码理论上要配 TTL)。
C 端其实不需要这层机制,手机号本身就是唯一标识,Redis key 用手机号拼就行;B 端登录页没有天然唯一标识,uuid 就是补上来的那一块。
关键设计点与取舍
为什么必须有图片验证码。 前面说过,B 端账号密码登录没有短信频控兜底,攻击面完全暴露。图形验证码把「自动化提交」变成「人肉识别」,一次爆破的成本从毫秒级拉高到肉眼识别一次,配合登录失败后刷新验证码的策略,暴力破解基本被摁死。C 端不加是因为短信验证码本身 60 秒一发、单日限量,已经有频控。
验证码用后即删。 实读 AdminService.login,验证码比对通过后紧跟一行 redisTemplate.delete(key)。如果不删,同一个验证码在 TTL 内可以被反复提交,验证码就失去了「每次交互一次性」的意义,这防的是重放。注意代码里只有比对成功才删除,失败不删,用户输错验证码后可以重试(页面上的验证码图也没换,此时旧验证码依然有效)。
MD5 比对密码。 登录时把用户输入的明文密码 SecureUtil.md5() 之后再和库里密文比对,方向是对的:库里不存明文。但要说清楚,MD5 是弱哈希,无盐、运算快,彩虹图一查一个准,生产环境应该用 BCrypt 这类带盐慢哈希(new BCryptPasswordEncoder().encode())。课程选 MD5 是为了少引一个依赖,把注意力留在流程上,这个账要心里有数。
JWT 双体系。 管理员的 token 和 C 端用户的 token 用的是同一个 JwtUtils.getToken()(mf-commons 里那份,HS512、密钥 mf),区别只在 payload:C 端塞的是用户 id,B 端塞的是 id + username。两套身份靠什么不串台?靠网关的路径隔离,/app/** 进 mf-app-server,/admin/** 进 mf-admin,网关统一鉴权的 excludedUrls 白名单里 C 端放行 /user/login、/user/loginVerification,B 端放行 /system/users/verification、/system/users/login,其余请求一律验 token(网关概述见项目架构:网关的概述)。另外 mf-admin 模块自己还注册了一个 TokenInterceptor,拦截 /** 并排除 login 和 verification 两个路径,解析 token 后把 Admin 塞进 AdminHolder,网关管「能不能进门」,拦截器管「进门前先亮明身份」,两层各司其职。
接口速览
接口统一经网关访问,实际请求路径带 /admin 前缀,网关 StripPrefix=1 后转发给 mf-admin,下表按工程内 Controller 的真实映射列出(实读 SystemController,类上 @RequestMapping("/system/users")):
| 接口 | 方法 | 路径(经网关) | 参数 | 返回 |
|---|---|---|---|---|
| 获取图片验证码 | GET | /admin/system/users/verification | query:uuid(前端生成) | 图片流(299×97),无 JSON |
| 管理员登录 | POST | /admin/system/users/login | body:username、password、verificationCode、uuid | {token} |
| 获取管理员资料 | POST | /admin/system/users/profile | Header:Authorization: Bearer {token} | AdminVo{id, username, avatar} |
三个接口的完整实现分别是后面三篇的主题:获取图片验证码、根据用户名密码登录获取 token、查询用户资料,这里不展开代码。
异常与边界
| 场景 | 服务端行为 | 说明 |
|---|---|---|
| 验证码错误 / uuid 对不上 | Redis 取不到值或值不等 → 抛 BusinessException("验证码错误") | 取不到值覆盖两种情况:没取过验证码、key 已被删 |
| 验证码过期 | 理论上靠 TTL 过期后取不到值 | 实读代码 set(key, code) 没传过期时间,是个坑,孤儿 key 会一直留着,建议补上 TTL |
| 账号不存在 / 密码错误 | 统一抛 BusinessException("用户名或者密码错误") | 不区分「账号不存在」和「密码错误」,避免给爆破方提供用户名枚举的口子 |
| 重复登录 | 签发新 token 返回,旧 token 在有效期内依然可用 | JWT 无状态,服务端不存 token,新 token 只是前端覆盖旧值;要「挤掉旧登录」得服务端维护会话状态,课程没做 |
| 未登录访问受保护接口 | 网关 AuthFilter 验 token 失败 → 401;mf-admin 拦截器白名单只放行 login 和 verification | profile 不在白名单里,必须带 token;另注意拦截器里 token.replace("Bearer ", "") 没做判空,请求头缺失会直接 NPE,这是工程简化写法 |
| 验证码比对通过但密码错误 | key 已被删 | 必须回登录页刷新验证码重来,天然多了一层消耗 |
验证要点
按流程顺序自测一遍,链路就验证完整了:
- 浏览器直接请求
http://<gateway>:8888/admin/system/users/verification?uuid=test001,应返回一张验证码图片; redis-cli执行keys CAP_CODE_*,能看到CAP_CODE_test001,get出验证码值并与图片比对;- POST
/admin/system/users/login,body 带{"username":"admin","password":"123456","verificationCode":"<上一步的值>","uuid":"test001"},拿到 token(可用 jwt.io 解开看 payload:id、username、7 天有效期); - 再次登录会报「验证码错误」,
redis-cli里那个 key 已经没了,用后即删生效; - 带
Authorization: Bearer <token>请求/admin/system/users/profile,返回{id, username, avatar};去掉 token 再请求,网关返回 401。
常见误解澄清
| 误解 | 实际情况 |
|---|---|
| 「验证码是前端生成的」 | 图片和文本都是 Java 服务端用 Hutool 生成的,前端只负责生成 uuid 和展示图片 |
| 「uuid 是后端返回的」 | uuid 由前端页面生成,登录时原样传回,后端只拿它拼 Redis key |
| 「登录成功就算登录完了」 | 还差第三步取资料,拿到 AdminVo 渲染出用户信息,页面才跳主页 |
| 「管理员的 token 和用户的 token 是两种 JWT」 | 同一个 JwtUtils 签的,密钥相同,只是 payload 内容和走的网关路径不同 |
| 「验证码校验失败也会删除 key」 | 实读代码只在比对通过后删除,失败保留,用户可重试 |
| 「MD5 加密了所以密码很安全」 | MD5 是弱哈希,生产应换 BCrypt 等带盐慢哈希 |
总结
- 管理员登录与 C 端登录是两套并行的体系:账号密码 + 图片验证码 vs 手机号 + 短信验证码,预置账号 vs 自动注册。
- 一次登录 = 三次请求:取验证码图片 → 登录取 token → 取资料进主页,uuid 是把验证码和这次登录会话绑在一起的粘合剂。
- 图片验证码在 B 端是刚需:账号密码登录没有短信频控保护,验证码 + 用后即删是抗爆破和抗重放的两道闸。
- 两套 JWT 共用同一个工具类,靠网关的
/admin/**、/app/**路径前缀和 excludedUrls 白名单区分体系;mf-admin 内部再用 TokenInterceptor + AdminHolder 补上身份传递。 - 已知短板:验证码 set 未设 TTL、MD5 弱哈希、拦截器未判空,都是课程为聚焦主线的取舍,生产化时逐一补齐。
下一篇进入第一步的实现:管理员登录:获取图片验证码。
3299



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



