Flask 是否有一种简单的方法在 Flask 中设置会话超时时间

在本文中，我们将介绍如何在 Flask 中设置会话（session）的超时时间。会话是一种在客户端和服务器之间跨请求存储数据的机制，它能帮助我们跟踪用户的状态和保持持续的用户体验。

阅读更多：Flask 教程

什么是会话超时时间？

会话超时时间是指会话在一段时间内没有任何活动时自动失效的时间。这样可以确保用户的敏感信息不会在长时间未激活状态下保留在服务器上。

常见的会话超时时间有两种：

绝对超时时间：会话在一段时间后无论是否有活动都会超时失效。
相对超时时间：会话在一段时间内没有活动后会超时失效，但如果会话在这段时间内有活动，则会话的超时时间将被延长。

设置会话超时时间

在 Flask 中设置会话超时时间可以使用 Flask-Session 扩展，它提供了一组用于管理会话的工具和函数。Flask-Session 扩展默认使用基于 Cookie 的会话，但也可以配置为将会话存储在服务器端的其他存储引擎中。

下面是一个使用 Flask-Session 扩展设置绝对超时时间的示例：

from flask import Flask, session
from flask_session import Session
from datetime import timedelta

app = Flask(__name__)

# 设置会话密钥
app.secret_key = "your_secret_key"

# 设置会话存储引擎为基于 Cookie 的会话
app.config["SESSION_TYPE"] = "filesystem"

# 设置会话超时时间为30分钟
app.config["PERMANENT_SESSION_LIFETIME"] = timedelta(minutes=30)

# 初始化会话扩展
Session(app)

@app.route("/")
def index():
    # 在会话中保存用户信息
    session["username"] = "John"
    return "Hello, {}!".format(session["username"])

if __name__ == "__main__":
    app.run()

在上面的示例中，我们首先导入了必要的模块和类，然后创建了一个 Flask 应用程序对象。然后，我们设置了应用程序的秘密密钥和会话存储引擎类型。接下来，我们通过设置 PERMANENT_SESSION_LIFETIME 属性为 timedelta(minutes=30) 来设置会话超时时间为30分钟。最后，我们通过调用 Session(app) 初始化会话扩展。

在路由函数中，我们将用户信息保存到会话中，并在页面上显示该用户的用户名。

这样，当用户的会话在30分钟内没有任何活动时，会话将自动失效并被清除。

自定义相对超时时间

如果希望设置相对超时时间，可以在会话中记录用户最后的活动时间，并通过定期检查该时间来判断会话是否已超时。以下是一个使用 Flask 自带的 before_request 装饰器来实现的示例：

from flask import Flask, session, request
from datetime import datetime, timedelta

app = Flask(__name__)
app.secret_key = "your_secret_key"

@app.before_request
def before_request():
    last_activity = session.get("last_activity")
    if last_activity is not None and datetime.now() - last_activity > timedelta(minutes=30):
        session.clear()
    session["last_activity"] = datetime.now()

@app.route("/")
def index():
    session["username"] = "John"
    return "Hello, {}!".format(session["username"])

if __name__ == "__main__":
    app.run()

在上面的示例中，我们使用了 Flask 的 before_request 装饰器来定义一个在每个请求之前执行的函数。在该函数中，我们首先检查会话中是否存在上次活动时间（last_activity），如果该时间存在且当前时间与上次活动时间的差值大于30分钟，则清除会话。接下来，我们将当前时间作为最新的活动时间，并将其保存在会话中。

这样，每当用户发送请求时，都会更新最新的活动时间。如果用户的会话在30分钟内没有任何活动，则会话将被清除。