Django使用request.session触发ModelBase无法JSON序列化TypeError

架构老林

2026-11-4

报错核心根因

该报错触发完全匹配Django默认会话的运行机制：

从Django 1.6开始，绝大多数内置会话后端（数据库、缓存、文件会话）默认使用django.core.signing.JSONSerializer完成session数据的序列化持久化，整个序列化流程由SessionMiddleware在视图返回响应后自动执行，开发者无需主动编写任何JSON处理逻辑就会触发该环节。
报错提示的ModelBase是所有Django模型类的元类——也就是说问题根源是session存储的内容中夹带了模型类本身（而非模型类的实例对象），这类类型不在JSON序列化的合法白名单内，自然会抛出类型错误。

为什么常规排查定位不到问题

按你描述的排查路径找不到来源是非常普遍的情况：

你检查的模板渲染上下文、视图返回逻辑本身没有问题——异常触发点在视图逻辑执行完成、模板渲染结束之后的会话持久化阶段，流程上和视图、模板逻辑无直接耦合。
session中的非法值往往来自隐式写入逻辑，而非当前检查的page_Category_Main视图中的显式赋值：比如全局中间件、被全局调用的装饰器、甚至你提到的自定义模板过滤器内部的session写入操作，都可能夹带了模型类对象。
直接打印session字典内容时，因为没有触发序列化流程，看不到类型不兼容问题，自然无法定位到非法值的来源。

可落地的排查与解决方案

第一步：快速定位非法session键
临时替换默认序列化器，精准捕获非法值来源：
在项目根目录新建session_debug_serializer.py：

from django.core.signing import JSONSerializer
class DebugJSONSerializer(JSONSerializer):
    @classmethod
    def dumps(cls, obj):
        # 逐键校验session存储的类型
        for session_key, session_value in obj.items():
            # JSON合法可序列化类型白名单
            valid_types = (str, int, float, list, dict, bool, type(None))
            if not isinstance(session_value, valid_types):
                raise TypeError(
                    f"定位到非法session内容：键名[{session_key}]，"
                    f"值的类型为{type(session_value)}，值为{session_value}"
                )
        return super().dumps(obj)

在settings.py中配置使用该调试序列化器：

SESSION_SERIALIZER = "你的项目名.session_debug_serializer.DebugJSONSerializer"

重启服务复现报错，会直接打印出到底哪个session键存了模型类对象，替代原本泛化的ModelBase不可序列化报错。

第二步：针对性排查高频写session的踩坑点
结合你提到开发了自定义模板过滤器的场景，重点检查这几类常见错误：
- 检查是否存在写session时的赋值笔误：比如本意是存Category.objects.get(id=xx)的模型实例，误写成了直接把Category模型类本身赋值给session键——这类笔误Python解释器不会触发语法报错，IDE的类型检查也经常无法识别。
- 检查从纯Python全局变量切换到session存储时，是否把原本存全局变量的模型类对象，未经类型转换直接同步到了session中。
- 检查全局权限、登录态校验的中间件逻辑，是否把关联的模型类作为校验标记写入了session。
第三步：临时验证方案
如果暂时无法定位问题代码，可以临时使用Pickle序列化器复现验证根因：
```
SESSION_SERIALIZER = "django.contrib.sessions.serializers.PickleSerializer"
```
注意：该方案仅用于本地调试定位问题，生产环境禁止使用Pickle序列化会话，存在远程代码执行的安全风险。

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