Redis 与缓存 / 系统课时

实现登录会话存储

实现登录会话存储

本课使用 Redis Hash 保存共享登录会话,设计会话键、空闲过期、绝对过期和主动退出流程,使多个应用实例能够统一校验登录状态。

学习目标

  • 设计会话键与必要字段
  • 同时实现空闲过期和绝对过期
  • 正确续期并清理退出会话

会话模型

客户端只保存高强度随机会话 ID,Redis 键使用 session:<sessionId>。Hash 可保存用户 ID、登录时间、最后访问时间和绝对过期时间,不应保存密码、验证码或完整敏感凭据。

登录会话生命周期

创建并读取会话

下面创建一个 30 分钟空闲过期、24 小时绝对过期的示例会话。时间戳为演示固定值,实际系统应使用服务端当前时间。

bash
KEY="session:sid-8f3a-demo-$$"

redis-cli HSET "$KEY" userId 1001 loginAt 1720000000000 lastAccessAt 1720000000000 absoluteExpireAt 1720086400000
redis-cli EXPIRE "$KEY" 1800
redis-cli HGET "$KEY" userId
redis-cli TTL "$KEY"

预期输出:

text
(integer) 4
(integer) 1
"1001"
<REMAINING_SECONDS>

<REMAINING_SECONDS> 应为大于 0 且不超过 1800 的整数。TTL 控制空闲过期,服务端还必须校验绝对过期时间。

原子续期与退出

续期时应先判断绝对过期,再把新的 TTL 设为“空闲时长”和“距离绝对过期的剩余时长”中的较小值。

lua
local key = KEYS[1]
local now = tonumber(ARGV[1])
local idleSeconds = tonumber(ARGV[2])

if redis.call("EXISTS", key) == 0 then
    return 0
end

local absoluteExpireAt = tonumber(redis.call("HGET", key, "absoluteExpireAt"))
if not absoluteExpireAt or now >= absoluteExpireAt then
    redis.call("DEL", key)
    return -1
end

local absoluteRemaining = math.floor((absoluteExpireAt - now + 999) / 1000)
local newTtl = math.min(idleSeconds, absoluteRemaining)

redis.call("HSET", key, "lastAccessAt", now)
redis.call("EXPIRE", key, newTtl)
return newTtl

将脚本保存为 refresh-session.lua,在同一终端继续执行续期和退出:

bash
redis-cli --eval refresh-session.lua "$KEY" , 1720000005000 1800
redis-cli DEL "$KEY"

预期输出:

text
(integer) 1800
(integer) 1

返回 0 表示会话不存在,-1 表示已经达到绝对过期时间。高并发接口可仅在 TTL 低于阈值时续期,减少写入。

安全清理

主动退出应立即删除当前会话。修改密码、冻结账户或发现凭据泄露时,还要使该用户的全部会话失效,可维护用户到会话 ID 的索引,或引入用户级会话版本号。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现登录会话存储

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

登录哪都通