Django ValuesQuerySet与Model对象转换JSON的完整指南

叶初

发布时间：2026-10-13 | 5人浏览过

原创

本文详解Django中ValuesQuerySet及Model对象转换为JSON的方法。通过切片将ValuesQuerySet转为列表后使用json.dumps即可；针对Model对象，利用__dict__属性并移除_state字段可解决序列化异常。文章涵盖简单对象、嵌套对象及列表查询的JSON处理方案，提供Python 3.6下的具体代码实现。

Django ValuesQuerySet转换为JSON的方法

在使用Django的ValuesQuerySet存储查询结果时，若需将其转换为JSON格式，无法直接调用json.dumps()进行序列化，必须经过中间转换步骤。


result_set = Apple.objects.all().values()

print type(result_set)
data_list = result_set[:] # queryset转为list
print type(data_list)

输出示例如下：


<class 'django.db.models.query.ValuesQuerySet'>
<type 'list'>

完成上述转换后，得到的data_list变量即可直接使用json.dumps()函数转换为标准的JSON字符串。

为什么需要ValuesQuerySet？

其核心作用是将数据库查询结果直接转换为字典形式，从而便于后续程序处理。

此外，它支持指定查询特定字段。例如执行Apple.objects.all().values('id')时，仅会返回表中id字段的数据，提高查询效率。

补充知识：Python对象转JSON【包括嵌套对象转JSON，django的model转json】

背景：

在开发Web应用接口时，经常需要将数据库Model对象转换为JSON格式并返回给客户端。

问题：

网络上虽存在类似方法，但搜索结果往往不够精准，耗时较长才能找到合适方案。此外，现有资料多集中于简单对象的处理，对于复杂或嵌套对象，缺乏高效且通用的解决方案。

方案(python3.6)：

1对象转json：

model类

Python对象转换为JSON的基础实现


class People():
  def __init__(self, name, age, pet):
    self.name = name
    self.age = age
    self.pet = pet
class Pet():
  def __init__(self, pet_type, pet_name):
    self.pet_type = pet_type
    self.pet_name = pet_name

将Pet对象转json：


import json
def pet2json():
  pet = Pet('Cat', 'Lili')
  js = json.dumps(pet.__dict__)
  print(js)

结果：

{“pet_type”: “Cat”, “pet_name”: “Lili”}

小结：充分利用了Python对象的dict方法，Python下一切皆对象，每个对象都有多个属性(attribute)，Python对属性有一套统一的管理方案。dict是用来存储对象属性的一个字典，其键为属性名，值为属性的值。dict可直接json化。

2嵌套对象转json：

刚才的People类可看做是嵌套类，即有一个属性是另一个类的实例，此时，若用上面的方法来json化Person对象，会有问题，如下【错误】：

嵌套对象的JSON序列化问题与解决


def simple_person():
  pet = Pet('Cat', 'Lili')
  p = People('Xiaoming', 12,pet)
  json_data = json.dumps(p.__dict__)
  print(json_data)

结果：

报异常TypeError: Object of type ‘Pet' is not JSON serializable

原因：json只能针对JSON serializable对象直接进行json化，而一般只有内置的类型，比如string,int,list和dict等才能直接序列化，代码中p._ dict _是个dict类型，但是其pet属性仍是自定义的类，是不能直接json化的。

解决方式【正确】：


def simple_person():
  pet = Pet('Cat', 'Lili')
  p = People('Xiaoming', 12,pet.__dict__)
  json_data = json.dumps(p.__dict__)
  print(json_data)

结果：

{“name”: “Xiaoming”, “age”: 12, “pet”: {“pet_type”: “Cat”, “pet_name”: “Lili”}}

小结：充分利用_ dict _方法。

3django的model转json：

首先有个model类

Django Model对象转换为JSON的最佳实践


class Person(models.Model):
  name = models.CharField(max_length=50, null=False)
  age = models.IntegerField(default=0)
  pid = models.CharField(max_length=20, unique=True)
  gender = models.IntegerField(default=0)

针对该Person类，有两种常见情况需要提供其json：

1：根据pid查询person记录；

2：根据某些条件，查询一些person记录。

此时数据库里已经插入了一些数据

这里要提一下网上比较常见的一种方式，需要用到django.core.serializers，这个类的serialize(format, queryset, **options)方法，很明显，这个方式只能作用与queryset格式，并且通过例子（不再列出），得到的结果类似这种 [{“model”: “polls.person”, “pk”: 2, “fields”: {“name”: “Cysion”, “age”: 29, “pid”: “3708261989”, “gender”: 0}}]，出现了model,pk，field等属性，不但用不到（对app来说），而且还增加了其它属性的使用复杂度。这个在官网的说明文档里也是如此处理，但是作者并不推荐。

方案：

我们还是使用_ dict _这个利器，首先，我们根据pid获得一个Person对象，然后利用dict方法打印看看结果（错误）


    req_pid=3708262007//request中得到
    try:
      rt = Person.objects.get(pid=req_pid)
      print(rt.__dict__)
      return HttpResponse(json.dumps(rt.__dict__),content_type='application/json')
      # return JsonResponse(rt.__dict__, safe=False)//另一种方式
    except:
      return JsonResponse(datalogic.get_comon_resp(1, '没有查询到对应数据'))

结果是：

print结果{‘_state': < django.db.models.base.ModelState object at 0x0000000004C80860 >, ‘id': 17, ‘name': ‘zhaoliu', ‘age': 10, ‘pid': ‘3708262007', ‘gender': 1}

啧啧，又多了些属性，特别是这个_state，是不能序列化的，所以上述并不能直接返回想要的结果。

解决方式：既然_state无用，且影响了结果，那我们直接临时除去，不就返回了想要的结果吗（正确）。


req_pid = request.POST.get('pid')
    try:
      rt = Person.objects.get(pid=req_pid)
      rt.__dict__.pop("_state")
      return JsonResponse(rt.__dict__, safe=False)
    except:
      return JsonResponse(datalogic.get_comon_resp(1, '没有查询到对应数据'))

接口返回结果是：


{
  "id": 17,
  "name": "zhaoliu",
  "age": 10,
  "pid": "3708262007",
  "gender": 1
}

正是客户端需要的。

最后，是返回列表的，比如需要这种结果


{
  "code": 0,
  "msg": "成功",
  "data": [
    {
      "id": 2,
      "name": "Cysion",
      "age": 29,
      "pid": "3708261989",
      "gender": 0
    },
    {
      "id": 11,
      "name": "Sophia",
      "age": 22,
      "pid": "3708261998",
      "gender": 1
    },
    {
      "id": 15,
      "name": "lisi",
      "age": 13,
      "pid": "3708262005",
      "gender": 0
    }
  ]
}

实现思路同上面类似，首先数据库查询后得到QuerySet，其不能直接json化（通过serializer得到的不好看，也不好处理，大量的属性处理还比较费劲），需要将其遍历得到每个对象，然后将其属性字典加入到list中，最后将其添加到通用dict中


pers = Person.objects.all()
result = {"code":0,"msg":"成功"}
L = []
for p in pers:
  p.__dict__.pop("_state")//需要除去，否则不能json化
  L.append(p.__dict__)//注意，实际是个json拼接的过程，不能直接添加对象
result ['data'] = L

这个时候result 就是个可以直接json化的对象了，通过