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

在 Session 保存登录数据

在 Session 保存登录数据

登录后的很多接口都会反复读取当前用户的少量信息,如果每次都查数据库,会造成无意义的重复访问。本篇使用 SaSession 保存这类登录期数据,并建立一条判断标准:哪些字段可以缓存,哪些必须回到真实数据源读取。

学习目标

  • 使用 StpUtil.getSession() 读写当前账号的 Account-Session。
  • 只缓存高频、体积小且允许短暂旧值的数据。
  • 为安全敏感和强一致数据保留实时查询或显式失效机制。

先明确 getSession 保存在哪里

StpUtil.getSession() 返回当前登录账号的 Account-Session。它以账号 ID 为主要关联对象,因此同一账号在多个客户端登录时,只要仍属于同一账号,读取到的是同一份账号级 Session 数据。

这和 StpUtil.getTokenSession() 不同:后者按 Token 隔离,更适合保存设备端、单次登录或单个 Token 独有的数据。当前课时讨论的是账号级高频数据,所以优先使用 getSession()。

SaSession 也不是 HttpSession。不要在 HttpSession 中写值,再期待从 SaSession 读取到同一份数据。

用最小字段写入和读取

下面是片段示例,依赖一个已经接入 Sa-Token 的 Spring Boot 项目,并在用户已登录的请求上下文中调用。示例只保存两个简单字段,而不是把完整用户实体塞进 Session。

java
import cn.dev33.satoken.session.SaSession;
import cn.dev33.satoken.stp.StpUtil;

public final class LoginSessionData {

    private static final String TENANT_ID = "tenantId";
    private static final String DISPLAY_NAME = "displayName";

    private LoginSessionData() {
    }

    public static void cacheProfile(long tenantId, String displayName) {
        SaSession session = StpUtil.getSession();
        session.set(TENANT_ID, tenantId);
        session.set(DISPLAY_NAME, displayName);
    }

    public static String readProfile() {
        SaSession session = StpUtil.getSession();
        Long tenantId = session.getLong(TENANT_ID);
        String displayName = session.getString(DISPLAY_NAME);
        return tenantId + ":" + displayName;
    }
}

调用 cacheProfile(2001L, "Alice") 后,在同一账号的有效登录会话中执行 readProfile(),预期结果为:

text
2001:Alice

实际项目里应在登录成功后或首次需要时写入,并在业务数据发生变化时同步更新或删除对应键。字段名集中成常量,可以减少多个业务模块各自拼写字符串带来的错误。

决定哪些数据应该缓存

判断标准不是“能不能放进去”,而是“允许不允许它短时间不是最新值”。

数据类型 建议 原因
展示名、语言偏好等展示信息 可放 Session 高频读取,通常允许短暂旧值
租户 ID、组织 ID 等登录上下文 可放,但变更时要失效 读取频繁,但不能长期保留过期归属
角色、权限、封禁状态 谨慎缓存 直接影响授权,变更后必须快速生效
余额、库存、订单状态 实时查询 属于业务事实,通常要求更强一致性
密码摘要、密钥、大对象 不放 Session 无必要且会扩大安全与序列化成本

如果租户或组织归属参与权限判断,Session 中的值只能作为登录上下文或查询加速信息,不能替代服务端真正的授权校验。

处理更新、注销与多节点部署

用户修改昵称后,可以重新写入 displayName;字段已经不需要时可调用 session.delete("displayName") 删除。因为这里使用的是 Account-Session,同一账号的不同 Token 会共享这份账号级数据;若业务需要“手机端和浏览器端各存一份”,应改用 Token-Session。

Session 只适合做会话期缓存,数据库仍应保存真实业务数据。默认内存存储在应用重启后会丢失;多节点部署若希望各节点读取同一登录数据,应接入适合的共享持久化方案并统一序列化规则。

把 Session 控制在“小、稳、可失效”的范围内,才能减少重复查询而不把它变成第二套数据库。

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

目录与阅读设置

阅读设置

17

记录一个想法

在 Session 保存登录数据

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

登录哪都通