Django中JsonResponse处理非字典对象报错及safe参数详解

南乔

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

原创

本文详解Django中JsonResponse返回非字典对象时触发的TypeError错误。通过设置safe=False参数，可允许列表等序列被序列化。文章结合源码分析safe参数的默认行为及修改方法，帮助开发者快速解决JSON响应格式报错问题。

Django JsonResponse报错现象与解决

在Django开发中，使用JsonResponse返回JSON格式数据时，可能会遇到类型错误。

例如，尝试直接返回一个字典： return JsonResponse({"name": "tom"})

此时系统会抛出以下报错信息：

TYPEERROR: In order to allow non-dict objects to be serialized

set the safe parmeter to False

针对该报错，解决方法如下：

在JsonResponse中增加safe=False参数： return JsonResponse({"name": "tom"}, safe=False)

通过设置safe=False，JsonResponse将接受列表等非字典对象进行序列化。

safe参数源码解析

补充知识：在Python中，调用JsonResponse(book_list, safe=False)时，若book_list为列表，需显式指定safe=False。

具体代码实现如下：


# 查询所有图书 、 增加图书
def get(self,request):

  queryset = BookInfo.objects.all()
  book_list = []

  for book in queryset:
    book_list.append({
      'id':book.id,
      'bread':book.bread

    })
  return JsonResponse (book_list,safe=False)

在实际操作中，可能会遇到如下问题：

JsonResponse (book_list,safe=False)

这里的safe=False具体含义是什么？

解决思路如下：

下载Django源码进行查看：


def __init__(self, data, encoder=DjangoJSONEncoder, safe=True,
       json_dumps_params=None, **kwargs):
  if safe and not isinstance(data, dict):
    raise TypeError(
      'In order to allow non-dict objects to be serialized set the '
      'safe parameter to False.'
    )
 
 if json_dumps_params is None:
    json_dumps_params = {}
  kwargs.setdefault('content_type', 'application/json')
  data = json.dumps(data, cls=encoder, **json_dumps_params)
  super(JsonResponse, self).__init__(content=data, **kwargs)

最终得出的结论是：