身份认证与应用安全 / 系统课时
读取当前登录用户身份
读取当前登录用户身份
接口进入业务层后,最常见的下一步不是再次解析 Token,而是取得当前登录账号的 loginId,再用它查询业务用户。这样认证框架只负责“当前是谁”,用户昵称、状态、组织等资料仍由业务数据源负责,身份边界更清晰。
学习目标
- 使用
StpUtil读取当前会话的loginId - 将认证身份稳定地映射到业务用户主键
- 正确处理未登录与业务用户不存在两类异常
loginId 是认证与业务之间的连接点
登录时传给 StpUtil.login(...) 的值就是后续认证上下文里的账号标识。若系统以数据库用户主键作为登录标识,例如登录成功后执行 StpUtil.login(10001L),业务接口即可通过 StpUtil.getLoginIdAsLong() 取回 10001。
关键原则是让 loginId 稳定、唯一、可回查。通常直接使用用户表主键最省事。不要把昵称、手机号等可能变化的字段当作长期身份键,也不必把整个用户对象塞进 Token;认证身份和业务资料应通过主键关联。
在接口中读取当前用户
下面是 Spring Web 中的片段示例,假设项目已经接入 Sa-Token,并在登录成功时以 Long 类型用户主键执行了 StpUtil.login(userId)。示例用内存数据代替数据库,只突出“读取身份再查业务用户”的路径。
package com.example.auth;
import cn.dev33.satoken.stp.StpUtil;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.server.ResponseStatusException;
import java.util.Map;
@RestController
public class CurrentUserController {
private static final Map<Long, UserView> USERS = Map.of(
10001L, new UserView(10001L, "alice", "editor")
);
@GetMapping("/api/me")
public UserView me() {
// 未登录时会由 Sa-Token 抛出 NotLoginException。
long userId = StpUtil.getLoginIdAsLong();
UserView user = USERS.get(userId);
if (user == null) {
throw new ResponseStatusException(
HttpStatus.NOT_FOUND, "业务用户不存在"
);
}
return user;
}
public record UserView(long id, String username, String role) {
}
}真实项目只需把 USERS.get(userId) 换成用户仓储或 Mapper 查询。认证层提供 userId,业务层再读取最新资料,因此用户改名、停用或角色调整后不会被旧的认证缓存长期遮蔽。
若当前 Token 对应的 loginId 为 10001,启动项目后可以请求:
curl -i -H "<TOKEN_NAME>: <TOKEN>" http://localhost:<PORT>/api/me其中 <TOKEN_NAME> 使用项目实际的 Token 名称,<TOKEN>、<PORT> 也替换为当前环境值。
预期结果:
HTTP/1.1 200
Content-Type: application/json
{"id":10001,"username":"alice","role":"editor"}选择正确的读取方式
StpUtil.getLoginId() 返回通用对象,适合账号标识类型不固定的项目;明确使用 long 主键时,getLoginIdAsLong() 可以减少手工转换。字符串账号则可使用 getLoginIdAsString()。
受保护接口通常直接使用会在未登录时抛出异常的读取方法,这能让“没有身份”尽早终止请求。只有业务本身允许匿名访问时,才适合使用可返回空值的读取方式,再由业务代码区分匿名用户与登录用户。
不要把 loginId 当成完整用户资料
loginId 解决的是身份定位,不等于完整的业务用户对象。权限、昵称、部门、账号状态等会变化的数据,仍应从权威数据源读取,或使用具有明确失效策略的缓存。
如果请求拿到了有效 loginId,却在用户表中找不到记录,应把它视为认证状态与业务数据不一致,而不是静默构造一个默认用户。这样可以尽早发现删号、数据迁移或缓存残留造成的问题。