You need to enable JavaScript to run this app. Django REST框架处理POST请求返回数组而非嵌套字典的原因排查
优惠活动
大模型
产品
解决方案
定价
更多

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解析嵌套表单的规则:
    data = {
        'token': 1234,
        'data[name]': 'test',
        'data[etc]': True
    }
    
    这种格式下Django解析request.POST时,会自动按照方括号的层级还原嵌套结构,读取request.POST['data']时就能拿到包含name、etc键的内层字典,完全匹配最初的结构预期。

内容的提问来源于stack exchange,提问作者mekanizm

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 07:15:04