← Back to all notes

PostgreSQL 与 Redis:权威数据和缓存职责分离

Published By 半盏灯 Last updated

  • Go
  • 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。

上线前用慢查询、连接池等待、缓存错误率这三类指标验证真实负载,比在压测环境里猜参数可靠。