0

0

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

霞舞

霞舞

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

|

190人浏览过

|

来源于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": ""})

⚠️ 重要注意事项

SekoTalk
SekoTalk

商汤科技推出的AI对口型视频创作工具

下载
  • 不要移除 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工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

151

2026.02.04

json数据格式
json数据格式

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

451

2023.08.07

json是什么
json是什么

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

546

2023.08.23

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

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

326

2023.10.13

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

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

81

2025.09.10

ajax教程
ajax教程

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

166

2023.06.14

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

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

170

2023.08.31

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

124

2023.11.15

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

48

2026.02.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.5万人学习

AngularJS教程
AngularJS教程

共24课时 | 3.9万人学习

CSS教程
CSS教程

共754课时 | 38.6万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号