Django Session 过期时间配置详解:Settings 参数与 set_expiry 方法对比

Finn
Finn
发布时间:2026-10-13| 3人浏览过
原创

本文详细解析 Django 中 Session 过期时间的两种配置方式。首先介绍 settings.py 中的 SESSION_COOKIE_AGE 和 SESSION_EXPIRE_AT_BROWSER_CLOSE 参数,并指出需开启 SESSION_SAVE_EVERY_REQUEST 方可生效。其次详解 request.session.set_expiry() 方法的四种取值逻辑,包括整数秒、时间对象、0 及 None 的行为差异,帮助开发者根据需求灵活控制会话生命周期。

Django Session 基础配置

Session 超时时间的设置

在 settings 配置文件中

  • SESSION_COOKIE_AGE=60*30,表示 30 分钟。
  • SESSION_EXPIRE_AT_BROWSER_CLOSE 为 False 时,会话 cookie 可以在用户浏览器中保持有效期;为 True 时,关闭浏览器则 Cookie 失效。
  • SESSION_COOKIE_DOMAIN 指定生效站点。
  • SESSION_COOKIE_NAME 定义 cookie 中保存 session 的名称。

Session 使用比较简单,在 request.session 是一个字典类。session 是保存在数据库中的。

-------------------------------------------------------

Settings 参数生效条件与限制

按手册和网上的方法在 settings.py 中设置“SESSION_COOKIE_AGE” 和 “SESSION_EXPIRE_AT_BROWSER_CLOSE” 均不生效。通过查看 django 的源代码“middleware.py”才知道这两个参数只有在 settings.SESSION_SAVE_EVERY_REQUEST 为 True 时才有效。依此在 settings.py 中设置这个变量后问题解决。

从源代码看 SESSION_EXPIRE_AT_BROWSER_CLOSE 为 True 时 SESSION_COOKIE_AGE 不生效。也就是说用户只能二选一,在浏览器关闭时使 session 失效 或 超时失效。

--------------------------------------------------------------

set_expiry 方法详解

下面这个方法不是在 settings 中用的

request.session.set_expiry(value)

你可以传递四种不同的值给它:

  • 如果 value 是个整数,session 会在些秒数后失效(适用于整个 Django 框架,即这个数值时效时整个页面都会 session 失效)。
  • 如果 value 是个 datatime 或 timedelta,session 就会在这个时间后失效。
  • 如果 value 是 0,用户关闭浏览器 session 就会失效。
  • 如果 value 是 None,session 会依赖全局 session 失效策略。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。