flask默认session不能跨进程共享，因其使用签名cookie将加密数据存于客户端，服务端无状态；需用flask-session+redis实现共享，关键配置包括session_type="redis"、session_redis传redis实例、显式设置session_key_prefix等。
Flask 默认 Session 为什么不能跨进程共享
Flask 自带的 session 默认用的是签名 Cookie，所有数据都加密后存在客户端浏览器里。这意味着：重启服务、换机器、开多个 gunicorn worker，都不会丢失状态——但这也意味着它**不真正“存储”在服务端**，没法做登录态强制下线、实时踢人、或存大对象（受 Cookie 4KB 限制）。一旦你需要集群部署或精细控制 session 生命周期，就必须把 session 搬到 Redis 这类外部存储。
用 Flask-Session 配 Redis 的关键配置项
核心是替换 Flask 的 session 接口，让 session 对象读写都走 Redis。不是改代码逻辑，而是改初始化方式：
-
SESSION_TYPE必须设为"redis"，否则扩展不启用 Redis 后端 -
SESSION_REDIS要传一个已连接的redis.Redis实例（推荐用连接池），别直接填字符串地址 -
SESSION_PERMANENT控制是否用permanent_session_lifetime，和 Redis 的EXPIRE命令联动；设为False时每次访问都会刷新过期时间 -
SESSION_KEY_PREFIX建议显式设置（如"flask_session:"），避免和其他应用 key 冲突
示例初始化片段：
from flask import Flask
from flask_session import Session
import redis
app = Flask(__name__)
app.config["SECRET_KEY"] = "your-secret-key"
app.config["SESSION_TYPE"] = "redis"
app.config["SESSION_PERMANENT"] = True
app.config["SESSION_USE_SIGNER"] = True
app.config["SESSION_KEY_PREFIX"] = "flask_session:"
app.config["SESSION_REDIS"] = redis.Redis(
host="127.0.0.1", port=6379, db=0, decode_responses=False
)
Session(app)
常见报错：RuntimeError: session is unavailable because no secret key was set
这个错误和 Redis 无关，是 Flask 底层校验没过。Flask-Session 在接管 session 前，仍依赖 Flask 原生的 secret_key 做 session ID 签名。只要漏设 app.secret_key 或 SECRET_KEY 配置，就会崩在这里。
- 必须确保
app.secret_key已赋值，且**不能是临时生成的随机值**（否则重启后旧 session 全失效） - 生产环境务必用固定密钥，比如从环境变量读：
app.secret_key = os.environ.get("FLASK_SECRET_KEY") - 如果用了
SESSION_USE_SIGNER=True（默认开启），密钥还用于保护 session ID 不被篡改
Redis 存 session 和存普通 key 的行为差异
Flask-Session 不是简单地把 dict 存成 JSON，它会序列化 + 加密 + 设置 TTL，所以你不能用 redis-cli 直接 GET 出明文内容。想调试，得注意三点：
- key 名是
SESSION_KEY_PREFIX+ 随机 session id（如"flask_session:abc123"） - value 是二进制数据（
decode_responses=False时），redis-cli里看到的是乱码，用redis-py读出来要先pickle.loads() - 过期时间不是靠 Redis 自动删，而是靠每次请求时 Flask-Session 主动调
EXPIRE更新——所以如果某个 session 长期没访问，对应 key 会一直留在 Redis 里，直到被 LRU 清掉或手动清理
真正需要清理僵尸 session？别指望 Redis TTL 自动兜底，得定期跑脚本扫描 KEYS flask_session:* + 检查最后访问时间字段（Flask-Session 不存这个字段，得自己加中间层）。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
