PostgreSQL 与 Redis:权威数据和缓存职责分离
权威数据放 PostgreSQL
认证服务的核心表:用户、接入应用、角色、权限、授权关系、refresh 会话、第三方绑定、审计流水。「不能重复」「必须一起成功」这类不变量交给数据库,而不是靠应用自觉。
CREATE UNIQUE INDEX ... WHERE deleted_at IS NULL; -- 软删除后账号可复用
几个值得抄的设计:
| 设计 | 解决了什么 |
|---|---|
| UUID 主键 | 对外 sub 不可枚举,便于多实例与迁移 |
| 软删除 + 部分唯一索引 | 留痕的同时允许注销后复用邮箱 / 用户名 |
| 密码版本号 | 改密即全量踢下线,无需遍历会话 |
| 状态零值是禁用 | 结构体零值不会意外通过鉴权(安全默认) |
| 审计表只追加 | 审计是取证记录,不提供修改入口 |
| 会话表只存摘要 | 令牌明文不落库,泄露数据库也拿不到可复用凭证 |
ORM 能省掉重复映射,但复杂查询仍要显式检查生成的 SQL、索引与事务边界;日志要开参数化输出,避免参数值(密码、令牌)进日志。
Redis 只放可丢的短期状态
所有键统一一个业务前缀,多环境共用一个实例时靠它隔离:
| 用途 | 键示例 | 丢了会怎样 |
|---|---|---|
| 登录票据 / OAuth state | ticket:* |
本次登录失败,重试即可 |
| 登录失败计数与锁定 | 按 account / ip | 降级到数据库字段 |
| access / 令牌族黑名单 | auth:bl:* / auth:blf:* |
能力失效,只能等令牌自然过期 |
| refresh 会话缓存 | 按 jti | 回落数据库,功能完整 |
| 导出任务状态 / 分布式锁 | 任务与锁键 | 多实例协调能力降级 |
判断归属只有一个问题:缓存清空后,正确性还成立吗? 会话缓存、限流计数属于「能重建」;一次性票据与黑名单属于「不能假装还在」。
会话是否吊销的判定必须只读数据库、不读缓存:这要以权威数据为准。缓存 TTL 收敛在 60 秒内,登出 / 改密 / 强制下线再主动删缓存。
关闭缓存会发生什么
缓存应该允许显式关闭,这是被支持的部署形态,但降级范围必须说清:
| 能力 | 关闭后 |
|---|---|
| 会话校验、轮换、重放检测、令牌族吊销 | 走数据库,完整可用 |
| access token 黑名单 | 失效,已吊销令牌最多还能用一个 access 有效期 |
| IP 维度登录限流 | 放弃并记 WARN |
| 一次性登录票据 | fail-closed,接口返回 503 |
区别在于「显式关闭」与「配了却连不上」:前者是预期状态,健康检查应显示缓存已禁用且整体仍健康;后者是环境故障,启动 fail-fast 直接失败。静默降级会让安全能力无声失效,比启动报错危险得多。
缓存一致性没有免费的双写
常见顺序是数据库先提交,再删除或更新缓存;对要求立即生效的会话撤销,关键路径直接查权威数据库,或短 TTL + 主动失效。若允许短暂延迟,也要量化最大窗口(这里是 60 秒),而不是笼统说「最终一致」。
鉴权是每请求都要走的热路径,任何一次额外查询都会抬升全站 P99。所以判断「access token 是否被吊销」时,令牌黑名单与令牌族黑名单用多键 EXISTS 合并为一次缓存往返,而不是查两次:
func isAccessRevoked(ctx context.Context, jti, familyID string) (bool, error)
连接池与事务边界也属于设计
database:
max_open_conns: 50
max_idle_conns: 10
conn_max_lifetime: 1h
conn_max_idle_time: 10m
最大连接数要结合数据库容量、实例数与并发峰值算,不能每个实例都按单机上限配。事务通过 context.Context 贯穿服务层与仓储层,请求取消时连接能及时释放;一个事务里不要塞慢网络调用(发邮件、拉远端公钥都在事务外)。
PostgreSQL 的一个硬约束:语句报错会把整个事务置为 aborted(25P02)。收到「唯一冲突」之后必须结束事务,不能在同一事务里继续写;要「忽略冲突继续」得先设
SAVEPOINT。
上线前用慢查询、连接池等待、缓存错误率这三类指标验证真实负载,比在压测环境里猜参数可靠。