Redis Key

最後更新 2026-10-21

go-jwt 在 Redis 中使用四種 key；本頁列出每種 key 的值、TTL，以及各操作如何讀寫它們。

Key 一覽

Key	值	TTL	用途
`refresh:<refreshID>`	`RefreshData` JSON	`RefreshIdExpires`；僅重簽時保留剩餘 TTL	工作階段資料
`jti:<jti>`	`"1"`	`AccessTokenExpires`	Access Token 白名單
`lock:refresh:<refreshID>`	鎖持有者 UUID	3 秒	刷新互斥鎖
`revoke:<accessToken>`	`"1"`	`AccessTokenExpires`	撤銷紀錄

Key 名稱固定。多個應用程式共用同一個 Redis DB 時，以 Config.Redis.DB 分開，避免 refresh:、lock: 等名稱衝突。

操作	讀	寫
`Create`	—	`MULTI`：`SETEX refresh:<id>`、`SETEX jti:<jti>`
`Verify`	`GET revoke:<token>`、`EXISTS jti:<jti>`	—
刷新：僅重簽	`GET`＋`TTL refresh:<id>`	`SETNX lock:`；`MULTI`：`SETEX refresh:<id>`（剩餘 TTL）、`SETEX jti:<新 jti>`；`EVAL` 解鎖
刷新：整組重發	`GET`＋`TTL refresh:<id>`	`SETNX lock:`；`SETEX refresh:<舊 id>` 3 秒；再執行 `Create` 的寫入；`EVAL` 解鎖
`Revoke`	`GET`＋`TTL refresh:<id>`	`MULTI`：`SETEX refresh:<id>` 5 秒、`SETEX revoke:<token>`

每個登入中的工作階段至少佔一筆 refresh:，加上 Access Token 有效期內的 jti: 一到數筆（僅重簽產生新 JTI 時舊的不會刪除，等 TTL 自然過期）。revoke: 的鍵含完整 JWT 字串，每筆約數百位元組，數量等於有效期內的登出次數。

if redis.call("get", KEYS[1]) == ARGV[1] then
	return redis.call("del", KEYS[1])
else
	return 0
end

只有鎖值等於自己的 UUID 時才刪除，避免刷新超過 3 秒、鎖已被其他請求取得時誤刪別人的鎖。