第12章 登录与权限

第 12 节 / 共 17 节 课程:前后端穿透

登录不是“比对一下密码”这么简单。它要回答四个问题:你是谁、你怎么证明、你登录后能做什么、你凭什么一直保持登录。

登录:把“你是谁”变成后续请求的凭证浏览器AuthControllerHttpSessionUserRepositoryPOST /api/loginfindByUsername查用户与密码哈希Optional<User>校验 BCryptSet-Cookie: JSESSIONID后续请求自动带 CookiegetAttribute("user")服务端 session 保存登录态;前端只拿到 Cookie,不接触密码哈希。
图 12-1 登录与后续请求的凭证流转

12.1 密码怎么存

数据库里绝不能存明文密码。也不要自己写 MD5 加盐。用 BCrypt、Argon2 这类专门做密码哈希的算法。

PasswordEncoder encoder = new BCryptPasswordEncoder();
String hash = encoder.encode("123456");
boolean ok = encoder.matches("123456", hash);

BCrypt 每次加密结果都不同,因为自带随机盐;校验时用 matches,不要自己比较字符串。哈希不可逆,忘记密码只能重置,不能找回。

密码、密钥、token 不要写进代码仓库,也不要打进前端包。前端代码是公开的。

12.2 Session 与 Token

方式存储位置优点缺点
Session服务端内存/Redis,客户端只存 sessionId可主动踢下线多机要共享,扩展麻烦
JWT客户端存 token,服务端验签无状态、易扩展注销难、过期前一直有效
Session + Redis服务端共享 session兼顾可控与扩展多一个 Redis 依赖

本站可以先用 Session,简单可靠;前后端分离、多端复用再考虑 JWT。不要为了“流行”上 JWT,最后连注销都做不了。

12.3 登录接口

@PostMapping("/login")
public Result<UserInfo> login(@RequestBody LoginForm form, HttpSession session) {
    User user = userService.findByUsername(form.username());
    if (user == null || !encoder.matches(form.password(), user.getPassword())) {
        return Result.fail("用户名或密码错误");
    }
    session.setAttribute("userId", user.getId());
    return Result.ok(new UserInfo(user.getId(), user.getUsername(), user.getNickname()));
}

错误提示统一为“用户名或密码错误”,不要分别提示“用户不存在”“密码错误”,否则等于帮攻击者枚举账号。

12.4 当前用户与退出

@GetMapping("/me")
public Result<UserInfo> me(HttpSession session) {
    Integer userId = (Integer) session.getAttribute("userId");
    if (userId == null) return Result.fail("401", "未登录");
    return Result.ok(userService.info(userId));
}
 
@PostMapping("/logout")
public Result<Void> logout(HttpSession session) {
    session.invalidate();
    return Result.ok(null);
}

前端启动时调一次 /me:200 说明已登录,401 就跳登录页。不要只信 localStorage 里有没有 token。

12.5 拦截器:统一校验登录

@Component
public class LoginInterceptor implements HandlerInterceptor {
 
    @Override
    public boolean preHandle(HttpServletRequest req, HttpServletResponse res, Object handler) throws Exception {
        if (req.getSession().getAttribute("userId") == null) {
            res.setStatus(401);
            res.setContentType("application/json;charset=UTF-8");
            res.getWriter().write("{\"code\":\"401\",\"info\":\"未登录\"}");
            return false;
        }
        return true;
    }
}

把拦截器注册到需要保护的路径,例如 /api/admin/**、/api/quiz/**,不要图省事拦截所有接口,否则登录接口自己也被拦。

12.6 授权:登录不等于有权限

普通用户登录后,仍然不能访问后台接口。每次请求都要判断角色或资源归属。

if (!"admin".equals(user.getRole())) {
    throw new BizException("403", "无权访问");
}
 
// 或者:只能改自己的数据
if (!course.getOwnerId().equals(currentUserId)) {
    throw new BizException("403", "只能修改自己的课程");
}
漏洞后果修法
只在前端隐藏按钮改请求就能调后台后端每个接口都校验
只校验登录不校验角色普通用户能进后台角色/资源归属判断
用 id 直接查越权看别人订单where 加 user_id
token 放 URL日志/Referer 泄露放 Authorization 头

12.7 前端登录态

// 登录成功后
localStorage.setItem('user', JSON.stringify(res.data))
 
// 请求携带 cookie(Session 方案)
axios.defaults.withCredentials = true
 
// 退出
await http.post('/logout')
localStorage.removeItem('user')
router.push('/login')

Session 方案要处理跨域 cookie:withCredentials、后端 allowCredentials、SameSite 三者要配套。生产同源反代最省事。

12.8 本章练习

  1. 实现注册、登录、退出、/me 四个接口。
  2. 用拦截器保护 /api/admin/**,未登录返回 401 JSON。
  3. 写一个“只能修改自己的资料”的接口,验证越权会被拒绝。

下一章讲文件上传:multipart、大小限制、类型校验、存储路径。