DRF APIClient中content_type=application/json与format=json的区别
DRF
APIClient 中 format="json" 与 content_type="application/json" 的差异 底层逻辑差异
format="json"是DRF为APIClient封装的高层快捷参数,传入后会自动完成两个动作:- 自动将传入的Python原生数据(字典、列表等)序列化为符合JSON规范的字符串,Python的
None会被正确转为JSON的null,布尔值、日期等类型也会做对应适配 - 自动在请求头中添加
Content-Type: application/json
- 自动将传入的Python原生数据(字典、列表等)序列化为符合JSON规范的字符串,Python的
content_type="application/json"是更基础的通用参数,仅会修改请求头的Content-Type字段。当你传入的请求数据是Python字典时,DRF的APIClient会识别到请求头的JSON标识,自动补做数据序列化的逻辑,所以也能解决None值解析异常的问题。
适用场景差异
- 常规接口测试,请求数据为Python原生结构时,优先用
format="json",代码更简洁,不需要关注序列化和请求头的匹配逻辑。format参数还支持其他内置格式,比如传format="multipart"就能自动处理文件上传的编码和头设置,灵活性更高。 - 当你已经手动将数据序列化为JSON字符串时,必须用
content_type="application/json",此时如果用format="json"会将已序列化的字符串再次做JSON转义,导致请求数据格式错误。
为什么两种参数都能解决None值解析问题
APIClient默认使用application/x-www-form-urlencoded或multipart/form-data编码提交数据,这两种编码格式没有对应PythonNone的标准实现,会把None转为空字符串或者直接丢弃字段。只要将请求编码切换为JSON格式,None就能被正确序列化为JSON的null,接口就能正常识别。
内容的提问来源于stack exchange,提问作者Michael
相关产品推荐
相关产品推荐

