32人参与 • 2025-12-28 • https
使用 streaminghttpresponse 来实现流式响应,也就是将数据分块返回给客户端,而不是一次性返回全部内容。这在处理大文件下载、实时数据推送等场景中非常实用。
streaminghttpresponse 是 django 提供的用于流式传输响应的类,它不会一次性将所有响应数据加载到内存中,而是通过迭代器逐块发送数据,适合:
先写一个基础示例,逐行返回文本数据:
from django.http import streaminghttpresponse
from django.views import view
import time
# 定义生成器函数,用于逐块生成数据
def stream_generator():
"""生成器函数,逐行返回数据(模拟实时生成内容)"""
for i in range(5):
# 模拟耗时操作(如读取大文件、实时计算)
time.sleep(1)
# 每块数据末尾加换行符,让客户端能实时看到
yield f"这是第 {i+1} 块数据\n"
class streamview(view):
def get(self, request):
# 创建 streaminghttpresponse,传入生成器
response = streaminghttpresponse(stream_generator())
# 设置响应头,确保客户端按流处理(可选但推荐)
response['content-type'] = 'text/plain; charset=utf-8'
# 禁用缓存,确保数据实时推送
response['cache-control'] = 'no-cache'
# 添加流式传输 headers,禁用缓冲
# 注意:transfer-encoding 和 connection 是 hop-by-hop headers,由 wsgi 服务器自动处理,不能在应用层设置
# response['cache-control'] = 'no-cache, no-store, must-revalidate'
# response['pragma'] = 'no-cache'
# response['expires'] = '0'
# response['x-accel-buffering'] = 'no' # 禁用 nginx 缓冲
# logger.info(f"[streamingview] streaminghttpresponse 已创建,headers 已配置用于流式传输")
return response
这是更实用的场景,避免一次性读取大文件到内存:
from django.http import streaminghttpresponse
from django.views import view
import os
def file_stream_generator(file_path, chunk_size=8192):
"""读取文件并逐块生成数据"""
with open(file_path, 'rb') as f:
while chunk := f.read(chunk_size):
yield chunk
class largefiledownloadview(view):
def get(self, request):
# 替换为你的大文件路径
file_path = "/path/to/your/large_file.zip"
if not os.path.exists(file_path):
return httpresponse("文件不存在", status=404)
# 获取文件名
file_name = os.path.basename(file_path)
# 创建流式响应
response = streaminghttpresponse(
file_stream_generator(file_path),
content_type='application/octet-stream' # 二进制文件类型
)
# 设置下载头,指定文件名
response['content-disposition'] = f'attachment; filename="{file_name}"'
# 设置分块传输编码
response['transfer-encoding'] = 'chunked'
return response
适用于实时通知、进度展示等场景:
from django.http import streaminghttpresponse
from django.views import view
import time
import json
def sse_generator():
"""生成 sse 格式的实时数据"""
for i in range(10):
time.sleep(1)
# sse 格式要求:data: 内容\n\n
data = json.dumps({"progress": i * 10, "message": f"处理中 {i*10}%"})
yield f"data: {data}\n\n"
class sseview(view):
def get(self, request):
response = streaminghttpresponse(sse_generator())
# sse 专用 content-type
response['content-type'] = 'text/event-stream'
# 禁用缓存和超时
response['cache-control'] = 'no-cache'
response['x-accel-buffering'] = 'no' # 禁用 nginx 缓冲(关键)
return response
streaminghttpresponse 的参数必须是可迭代对象(如生成器函数),不能是普通列表(否则会一次性加载)。response['x-accel-buffering'] = 'no',否则 nginx 会缓冲数据直到生成器结束才推送。setenv no-gzip 1 禁用压缩缓冲。def stream_generator():
try:
for i in range(5):
time.sleep(1)
yield f"第 {i+1} 块数据\n"
except exception as e:
yield f"出错了:{str(e)}\n"
gzipmiddleware)会缓冲响应,导致流式失效,需排除这些中间件。streaminghttpresponse 核心是通过生成器逐块返回数据,避免一次性加载大量数据到内存,适合大文件、实时数据场景。content-type(如文件下载用 application/octet-stream,sse 用 text/event-stream)。在 urls.py 中添加路由:
from django.urls import path
from .views import streamview, largefiledownloadview, sseview
urlpatterns = [
path('stream/', streamview.as_view(), name='stream'),
path('download-large-file/', largefiledownloadview.as_view(), name='download'),
path('sse/', sseview.as_view(), name='sse'),
]
到此这篇关于django使用streaminghttpresponse实现流式响应的实现示例的文章就介绍到这了,更多相关django流式响应内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
您想发表意见!!点此发布评论
版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。
发表评论