Django中含模型实例的字典序列化报错，求解决方法

这个问题我之前也碰到过——你的context字典里混了模型实例、QuerySet、视图对象、表单这些Python复杂对象，而JSON只能序列化字符串、数字、列表、字典这类基础数据类型，默认编码器根本不知道怎么处理它们，所以才会抛出TypeError: is not JSON serializable的错误。下面给你几个实用的解决思路：

方法一：只序列化前端需要的字段（推荐） #

其实前端大概率不需要整个模型实例或表单的所有属性，手动提取需要的数据是最可控、性能最好的方式。你可以把context里的内容拆成前端能用的简单结构：

context = self.get_context_data()
html = render_to_string('difficult_test.html', context)

# 手动序列化需要的字段
serialized_context = {
    # 处理Test实例，提取有用字段
    'test': {
        'id': context['test'].id,
        'display_name': str(context['test']),
        'status': context['test'].status  # 假设Test模型有status字段
    },
    # 处理answers QuerySet，逐个提取属性
    'answers': [
        {
            'question_nr': ans.question_nr,
            'answer_nr': ans.answer_nr,
            'correct': ans.correct
        } for ans in context['answers']
    ],
    # 处理TestQuestion实例
    'test_question': {
        'nr': context['test_question'].nr,
        'content': context['test_question'].content  # 假设问题有content字段
    },
    # 按钮列表本来就是基础类型，直接复用
    'test_button_list': context['test_button_list'],
    # 表单如果前端不需要可以直接去掉，或者只返回字段名
    # 'form_fields': list(context['form'].fields.keys())
}

# 视图对象对前端没用，直接排除
if self.request.is_ajax():
    return JsonResponse({"html": html, "context": serialized_context})
return response

这种方式的好处是你完全掌控返回的数据，不会把不必要的属性传给前端，也避免了序列化复杂对象的麻烦。

方法二：自定义JSON编码器 #

如果需要频繁序列化这类Django对象，可以写一个自定义的JSON编码器，让它自动处理模型实例、QuerySet等对象：

首先导入需要的模块：

import json
from django.http import JsonResponse
from django.forms.models import model_to_dict

然后定义编码器：

class DjangoJSONEncoder(json.JSONEncoder):
    def default(self, obj):
        # 处理Django模型实例，转成字典
        if hasattr(obj, '_meta'):
            return model_to_dict(obj)
        # 处理QuerySet，转成列表
        elif hasattr(obj, '__iter__') and not isinstance(obj, (str, bytes, dict)):
            return list(obj)
        # 处理表单，只返回字段信息
        elif hasattr(obj, 'fields'):
            return {field_name: str(field) for field_name, field in obj.fields.items()}
        # 其他情况交给默认编码器处理
        return super().default(obj)

然后在返回JsonResponse的时候指定这个编码器：

context = self.get_context_data()
# 先把没用的视图对象删掉
context.pop('view', None)
html = render_to_string('difficult_test.html', context)

if self.request.is_ajax():
    return JsonResponse(
        {"html": html, "context": context},
        encoder=DjangoJSONEncoder
    )
return response

注意：model_to_dict只会序列化模型的字段，不会包含__str__方法返回的内容，如果需要的话可以手动添加。另外，视图对象view对前端毫无意义，最好提前从context里移除。

方法三：用Django内置序列化器处理模型和QuerySet #

Django自带了序列化工具，可以直接把模型实例和QuerySet转成JSON格式：

import json
from django.core import serializers
from django.http import JsonResponse

context = self.get_context_data()
html = render_to_string('difficult_test.html', context)

# 序列化单个模型实例
test_data = json.loads(serializers.serialize('json', [context['test']]))[0]['fields']
# 序列化QuerySet
answers_data = json.loads(serializers.serialize('json', context['answers']))
answers_data = [item['fields'] for item in answers_data]
# 序列化TestQuestion实例
test_question_data = json.loads(serializers.serialize('json', [context['test_question']]))[0]['fields']

serialized_context = {
    'test': test_data,
    'answers': answers_data,
    'test_question': test_question_data,
    'test_button_list': context['test_button_list'],
    # 表单和视图对象按需处理或移除
}

if self.request.is_ajax():
    return JsonResponse({"html": html, "context": serialized_context})
return response

这种方法适合需要序列化大量模型实例的场景，不用手动写字段映射，但返回的数据会包含模型的所有字段，可能有冗余。

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