身份认证与应用安全 / 系统课时

读取当前登录用户身份

读取当前登录用户身份

接口进入业务层后,最常见的下一步不是再次解析 Token,而是取得当前登录账号的 loginId,再用它查询业务用户。这样认证框架只负责“当前是谁”,用户昵称、状态、组织等资料仍由业务数据源负责,身份边界更清晰。

学习目标

  • 使用 StpUtil 读取当前会话的 loginId
  • 将认证身份稳定地映射到业务用户主键
  • 正确处理未登录与业务用户不存在两类异常

loginId 是认证与业务之间的连接点

登录时传给 StpUtil.login(...) 的值就是后续认证上下文里的账号标识。若系统以数据库用户主键作为登录标识,例如登录成功后执行 StpUtil.login(10001L),业务接口即可通过 StpUtil.getLoginIdAsLong() 取回 10001。

关键原则是让 loginId 稳定、唯一、可回查。通常直接使用用户表主键最省事。不要把昵称、手机号等可能变化的字段当作长期身份键,也不必把整个用户对象塞进 Token;认证身份和业务资料应通过主键关联。

在接口中读取当前用户

下面是 Spring Web 中的片段示例,假设项目已经接入 Sa-Token,并在登录成功时以 Long 类型用户主键执行了 StpUtil.login(userId)。示例用内存数据代替数据库,只突出“读取身份再查业务用户”的路径。

java
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,启动项目后可以请求:

bash
curl -i -H "<TOKEN_NAME>: <TOKEN>" http://localhost:<PORT>/api/me

其中 <TOKEN_NAME> 使用项目实际的 Token 名称,<TOKEN>、<PORT> 也替换为当前环境值。

预期结果:

text
HTTP/1.1 200
Content-Type: application/json

{"id":10001,"username":"alice","role":"editor"}

选择正确的读取方式

StpUtil.getLoginId() 返回通用对象,适合账号标识类型不固定的项目;明确使用 long 主键时,getLoginIdAsLong() 可以减少手工转换。字符串账号则可使用 getLoginIdAsString()。

受保护接口通常直接使用会在未登录时抛出异常的读取方法,这能让“没有身份”尽早终止请求。只有业务本身允许匿名访问时,才适合使用可返回空值的读取方式,再由业务代码区分匿名用户与登录用户。

不要把 loginId 当成完整用户资料

loginId 解决的是身份定位,不等于完整的业务用户对象。权限、昵称、部门、账号状态等会变化的数据,仍应从权威数据源读取,或使用具有明确失效策略的缓存。

如果请求拿到了有效 loginId,却在用户表中找不到记录,应把它视为认证状态与业务数据不一致,而不是静默构造一个默认用户。这样可以尽早发现删号、数据迁移或缓存残留造成的问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取当前登录用户身份

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通