Django REST框架处理POST请求返回数组而非嵌套字典的原因排查
问题根因与解决方法
核心原因
这个问题完全是两类规则不匹配导致的,不存在什么隐藏的配置问题:
- 第一,
requests.post()用data参数传值时,默认的请求编码是application/x-www-form-urlencoded,这种格式天生就是为扁平键值对设计的,从设计逻辑上就不支持直接传输嵌套字典结构。 - 第二,
requests处理data参数时,不会自动帮你给嵌套字典做兼容序列化:当你把内层字典直接当data键的值传入时,库内部的URL编码逻辑会把字典当成可迭代对象直接遍历——遍历普通字典时默认只会吐出它的键(也就是你例子里的name、etc),最后实际拼出来发出去的表单报文是token=1234&data=name&data=etc,和你预期的嵌套结构差异极大。 - 第三,Django解析
request.POST的逻辑是严格按照收到的表单报文生成QueryDict的,既然发出去的报文里data键对应两个值name和etc,那解析出来自然就是你看到的<QueryDict: {'token':[1234], 'data':['name', 'etc']}>,根本不会生成你预想的嵌套字典结构。
正确的实现方案
- 发送结构化嵌套业务数据时,直接用requests内置的JSON序列化能力
把原来写法里的data=data替换为json=data就行:
这种写法下requests.post('目标url', json=data)requests会自动把整个字典序列化为合法的JSON字符串,同时自动设置Content-Type: application/json请求头。因为你的服务端是基于DRF做的REST接口,本身就内置了JSON解析器,直接通过request.data就能完整拿到你定义的嵌套结构,不需要手动读取请求体做JSON解析。 - 如果因老系统兼容要求必须走表单编码接口,需要按照Django表单的嵌套规则手动构造键名
不能直接把字典当值传入,要给每个内层层级的键加上方括号标识,符合Django解析嵌套表单的规则:
这种格式下Django解析data = { 'token': 1234, 'data[name]': 'test', 'data[etc]': True }request.POST时,会自动按照方括号的层级还原嵌套结构,读取request.POST['data']时就能拿到包含name、etc键的内层字典,完全匹配最初的结构预期。
内容的提问来源于stack exchange,提问作者mekanizm
相关产品推荐
相关产品推荐

