Django 数据库查询结果转换为 JSON 的两种实现方式

向北走

发布时间：2026-10-14| 3人浏览过

原创

本文介绍在 Django 框架中将数据库查询结果转换为 JSON 格式的两种方法。第一种使用 serializers.serialize 直接返回标准 JSON 结构，包含 fields、model 和 pk 字段；第二种通过约定返回格式，将数据封装在 data 字段中。此外，还展示了利用 model_to_dict 将单个对象转换为纯字典并返回 JSON 的优化方案，以简化前端解析逻辑。

在与前端进行数据交互时，通常统一使用 JSON 格式。因此，需要将数据库查询到的结果转换为标准的 JSON 格式以便传输。

当需要返回多条数据记录时，可以采用特定的序列化方式处理查询集。

具体实现示例如下所示。


import json
from django.http import HttpResponse
from django.core import serializers
def db_to_json(request):
    scripts = Scripts.objects.all()[0:1]
    json_data = serializers.serialize('json', scripts)
    return HttpResponse(json_data, content_type="application/json")

执行上述代码后，得到的返回结果如下所示。


[{
 "fields": {
  "script_content": "abc",
  "script_type": "1"
 },
 "model": "home_application.scripts",
 "pk": "03a0a7cf-567a-11e9-8566-9828a60543bb"
}]

功能虽然已实现，但为了符合前后端约定的数据规范，需要将查询结果封装在名为 data 的字段中。

{\"message\": 'success', \"code\": '0', \"data\": []}

实现该约定格式的代码如下。


import json
from django.http import HttpResponse
from django.core import serializers
def db_to_json2(request):
    # 和前端约定的返回格式
    result = {"message": 'success', "code": '0', "data": []}
    scripts = Scripts.objects.all()[0:1]
    # 序列化为 Python 对象
    result["data"] = serializers.serialize('python', scripts)
    # 转换为 JSON 字符串并返回
    return HttpResponse(json.dumps(result), content_type="application/json")

调用该接口后，返回的 JSON 数据如下。


{
 "message": "success",
 "code": "0",
 "data": [{
  "fields": {
   "script_content": "abc",
   "script_type": "1"
  },
  "model": "home_application.scripts",
  "pk": "03a0a7cf-567a-11e9-8566-9828a60543bb"
 }]
}

需要注意的是，每条数据对象中包含了 fields、model 和 pk 三个字段，分别代表字段内容、模型名称及主键。虽然可以进一步处理以获取仅包含字段的字典对象，但为了节省后端性能开销，建议将解析工作交给前端处理。