You need to enable JavaScript to run this app. 如何停止Django渲染JSON响应 实现DRF接口始终返回原始数据
优惠活动
大模型
产品
解决方案
定价
更多

如何停止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渲染器调整响应头:

  1. 在项目任意可导入的路径下写自定义渲染器:
from rest_framework.renderers import JSONRenderer

class PlainRawJSONRenderer(JSONRenderer):
    # 调整媒体类型,避免触发浏览器自动JSON预览
    media_type = 'text/plain'
    format = 'json'
  1. 修改DRF全局配置,替换默认渲染器:
REST_FRAMEWORK = {
    'DEFAULT_RENDERER_CLASSES': (
        '你的项目路径.渲染器文件.PlainRawJSONRenderer',
    ),
}

调整后接口返回的内容依然是标准JSON格式,只是因为响应头的Content-Type为text/plain,浏览器不会再触发自动高亮解析,直接展示纯Raw文本。

4. 其他常见排查点

如果改完配置还是看到带HTML包装的渲染页面,检查两个方向:

  • 项目的全局中间件、装饰器是否对JSON响应做了额外的HTML包装处理
  • 你写的ViewSet是否完全基于DRF的视图基类开发,没有混用Django原生视图的返回逻辑

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.04 17:24:07