如何停止Django渲染JSON响应 实现DRF接口始终返回原始数据
1. 先修正你当前配置的语法bug
你写的DRF配置存在Python单元素元组的经典坑:单元素元组必须在元素末尾加逗号,否则Python会把括号里的内容解析为普通字符串,导致DRF根本读不到有效的渲染器配置,直接回退到默认逻辑。
你当前的写法:
'DEFAULT_RENDERER_CLASSES': ('rest_framework.renderers.JSONRenderer')
这行代码运行时会被识别为一个普通字符串,不是合法的单元素元组,配置完全不生效。
补全逗号后的正确配置:
REST_FRAMEWORK = { 'DEFAULT_RENDERER_CLASSES': ( 'rest_framework.renderers.JSONRenderer', ), }
改完记得重启Django服务让配置生效。
2. 区分浏览器预览和后端真实响应
重启后如果在浏览器访问接口,还是看到折叠高亮的JSON格式化页面,这个不是后端返回了HTML内容——这是现代浏览器(Chrome、Edge等)自带的客户端功能:只要后端返回的Content-Type头包含application/json,浏览器就会自动把原始JSON解析成高亮折叠的可视化页面,和后端代码无关。
想验证后端是不是真的返回了Raw Data,直接用curl、Postman或者浏览器开发者工具的网络面板看原始响应体,此时看到的就是没有任何HTML包装的纯JSON字符串,完全符合接口返回要求。
3. 强制浏览器直接展示Raw原始内容(可选)
如果你就是不想要浏览器的自动高亮效果,打开接口就看到纯文本原始数据,可以自定义DRF渲染器调整响应头:
- 在项目任意可导入的路径下写自定义渲染器:
from rest_framework.renderers import JSONRenderer class PlainRawJSONRenderer(JSONRenderer): # 调整媒体类型,避免触发浏览器自动JSON预览 media_type = 'text/plain' format = 'json'
- 修改DRF全局配置,替换默认渲染器:
REST_FRAMEWORK = { 'DEFAULT_RENDERER_CLASSES': ( '你的项目路径.渲染器文件.PlainRawJSONRenderer', ), }
调整后接口返回的内容依然是标准JSON格式,只是因为响应头的Content-Type为text/plain,浏览器不会再触发自动高亮解析,直接展示纯Raw文本。
4. 其他常见排查点
如果改完配置还是看到带HTML包装的渲染页面,检查两个方向:
- 项目的全局中间件、装饰器是否对JSON响应做了额外的HTML包装处理
- 你写的ViewSet是否完全基于DRF的视图基类开发,没有混用Django原生视图的返回逻辑
内容的提问来源于stack exchange,提问作者Mohammad

