讲师中心 微信公众号
AI工具推荐 视频效率加速

Django 视图中同时支持 JSON 响应与 HTML 渲染的正确实践

千敏姑娘_7925

千敏姑娘_7925

发布时间:2026-01-14 11:55:27

|

210人浏览过

|

来源于php中文网

原创

Django 视图中同时支持 JSON 响应与 HTML 渲染的正确实践

在 django 中,`jsonresponse` 仅返回纯 json 数据,无法渲染 html 模板;若需同一 url 同时支持 ajax 请求(返回 json)和直接访问(返回网页),应通过请求头(如 `accept`)动态判断并分别响应。

Django 的视图函数本质上是“单入口、多出口”的逻辑单元——它可以根据请求上下文灵活选择响应类型。关键在于区分请求意图:前端通过 AJAX 发起的异步调用通常携带 Accept: application/json 头,而浏览器直接访问 URL 则默认发送 Accept: text/html,*/*。利用这一差异,即可实现“一址双用”。

以下是推荐的改进方案(兼容您现有代码结构):

from django.shortcuts import render
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from django.utils.decorators import method_decorator

@csrf_exempt  # 仅当未使用 CSRF Token 时临时添加(生产环境建议配合 {% csrf_token %})
def update_text(request):
    if request.method == "POST":
        text = request.POST.get("text", "").strip()

        # 判断请求是否期望 JSON 响应
        if request.accepts('application/json'):
            # 返回结构化 JSON,便于前端健壮处理
            return JsonResponse({"output": f"Processed: '{text}'"})
        else:
            # 非 AJAX 请求(如手动输入 URL),返回完整 HTML 页面
            return render(request, "realtime_input.html", {"initial_text": text})

    # GET 请求:直接渲染初始页面(推荐方式)
    return render(request, "realtime_input.html", {"initial_text": ""})

⚠️ 重要注意事项

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载
  • 不要移除 CSRF 保护:您的前端 AJAX 请求应包含 CSRF Token。在模板中添加 {% csrf_token %} 并在 JS 中读取 input[name=csrfmiddlewaretoken] 的值,或使用 django.middleware.csrf.get_token(request) 在上下文中传递。
  • safe=False 通常不必要:JsonResponse 默认要求字典类型;若传入字符串需 safe=False,但更佳实践是始终返回结构化字典(如 {"output": "..."}),提升可维护性与前端解析安全性。
  • HTML 模板需统一路径:确保 realtime_input.html 存放于正确 templates/ 目录下,并在 settings.py 中配置 TEMPLATES。
  • 避免混合响应逻辑:切勿在 JsonResponse 中尝试调用 render() —— 二者底层响应类不同(JsonResponse 继承自 HttpResponse,但设置 content_type="application/json"),强行混用将导致异常或不可预测行为。

总结:Django 的优雅之处正在于其请求/响应的可塑性。通过 request.accepts() 精准识别客户端意图,配合合理的视图分发逻辑,即可在单一 URL 上无缝支撑实时交互(AJAX+JSON)与传统页面导航(HTML+render),无需拆分路由或牺牲用户体验。

立即学习前端免费学习笔记(深入)”;

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

493

2026.02.04

Python Django REST Framework接口安全与认证体系实践
Python Django REST Framework接口安全与认证体系实践

本专题围绕 Django REST Framework 展开,深入讲解 API 认证、JWT 鉴权、权限控制、接口安全防护以及防攻击策略设计。通过完整后端案例,帮助开发者构建安全可靠的 Web API 服务体系。

180

2026.06.29

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

1955

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2622

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

916

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2919

2025.09.10

ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2300

2023.06.14

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.08.31

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

0

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 208人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn