如何扩展Django request对象 规范跨视图session数据存取

Python本身没有提供和Kotlin完全一致的扩展属性语法，但依托Python的描述符特性和Django的扩展机制，可以实现效果完全一致、甚至更易维护的写法，不需要额外安装第三方包。

最常用的实现是写一个通用的Session属性描述符，再集中挂载到Django的HttpRequest类上：

# 放在项目核心目录的工具模块里，比如core/utils.py
class SessionProperty:
    def __init__(self, session_key: str, default=None):
        self.session_key = session_key
        self.default = default

    def __get__(self, request_instance, request_class):
        if request_instance is None:
            return self
        return request_instance.session.get(self.session_key, self.default)

    def __set__(self, request_instance, value):
        request_instance.session[self.session_key] = value
        request_instance.session.modified = True

    def __delete__(self, request_instance):
        if self.session_key in request_instance.session:
            del request_instance.session[self.session_key]
            request_instance.session.modified = True

挂载逻辑放在对应App的配置类ready方法里执行，保证Django启动时就完成属性注入：

# core/apps.py
from django.apps import AppConfig
from django.http import HttpRequest
from .utils import SessionProperty

class CoreConfig(AppConfig):
    name = "myproject.core"

    def ready(self):
        # 所有session属性集中在这里注册，全局唯一入口
        HttpRequest.my_session_key = SessionProperty("my_session_key", default=0)
        HttpRequest.current_order_step = SessionProperty("current_order_step")
        HttpRequest.form_draft = SessionProperty("form_draft", default={})

配置完成后，就可以直接在视图里用request.my_session_key读写，和Kotlin扩展属性的用法完全一致：

def view_one(request):
    # 赋值自动写入session
    request.my_session_key = 123

def view_two(request):
    # 读取自动从session取值
    data = request.my_session_key

如果需要IDE补全和类型检查，可以在项目里加一个简单的类型声明文件，把自定义的session属性列出来即可，开发体验和原生属性没有区别。

• 所有session键全局集中管理：绝对不要在视图、工具代码里硬编码session键名字符串。要么用上面的SessionProperty方案在统一入口注册所有键，要么最少也要把所有键名定义为常量放在单独的constants.py文件中，所有读写逻辑都引用常量。这种方式下要梳理全项目在用的session键，只需要看注册入口或者常量文件就行，不会出现散落在各处的硬编码。
• 按业务域做命名空间隔离：不要把所有键平铺在session根层级，同一业务场景的相关数据存在同一个字典键下，比如多步订单流程的所有临时状态，都存在request.session["order_flow"]这个字典里，包含订单id、当前步骤、临时表单值等字段，既避免不同业务的键名冲突，流程结束时也可以一次性删除整个业务域的临时数据，不会留冗余垃圾数据。
• 严格控制session存储内容：session存储后端（数据库/缓存）的读写性能远低于内存，不要存大体积数据，也不要直接存ORM模型对象。只存必要的轻量标识（比如主键、状态枚举值、短字符串），需要完整数据时通过主键查库，避免session体积过大拖慢请求，同时避免session里存的数据和数据库实际数据不一致。
• 明确每个session字段的生命周期：临时数据（比如多步表单中间值、一次性提示信息）要在使用完成后主动删除，不要长期残留在session中。对有过期要求的字段，可以在存值的时候附带时间戳，读取时判断是否过期，过期就自动清理。
• 复杂跨视图流程不要全堆session：如果是跨多页面、需要长时间保留、甚至支持跨设备恢复的流程状态，不要全部存在session里，可以单独建一张流程状态表存数据库，session里只存对应状态记录的主键，可维护性和可靠性远高于纯session存储。

额外提醒：session是用户维度隔离的存储，不要用它做不同用户之间的数据共享，跨用户通信走缓存或者数据库即可。

内容的提问来源于stack exchange，提问作者Anonymous Django