在Django项目部署到Apache环境的实际场景中，生成和下载大体积PDF文件是常见需求，但这类操作很容易引发内存占用过高、响应超时、下载中断等问题，需要从生成、下载、服务器配置多个层面做针对性优化。
大文件PDF处理的常见瓶颈
在Apache+Django的部署架构下，处理大PDF文件时主要存在三类问题：
- PDF生成阶段如果一次性将全部内容加载到内存，会导致Django进程内存占用飙升，甚至触发Apache的进程内存限制被强制终止
- 下载阶段如果直接返回完整文件内容，会占用大量服务器带宽，且一旦网络波动就会导致下载失败，用户需要重新下载
- Apache默认配置对大文件传输的支持不足，容易出现请求超时、连接中断的情况
PDF生成阶段的优化策略
使用流式生成替代全量加载
如果使用ReportLab等库生成PDF，建议采用流式写入的方式，避免将整个PDF内容保存在内存中。以下是基于ReportLab的流式生成示例：
import io
from reportlab.pdfgen import canvas
from django.http import StreamingHttpResponse
def generate_large_pdf():
# 创建字节流缓冲区，边生成边写入，不一次性加载全部内容
buffer = io.BytesIO()
p = canvas.Canvas(buffer)
# 假设需要生成1000页内容，逐页写入
for i in range(1000):
p.drawString(100, 750, f"第{i+1}页内容")
p.showPage()
p.save()
buffer.seek(0)
return buffer
def pdf_generate_view(request):
buffer = generate_large_pdf()
response = StreamingHttpResponse(buffer, content_type='application/pdf')
response['Content-Disposition'] = 'attachment; filename="large_file.pdf"'
return response
异步生成大体积PDF
如果PDF生成逻辑复杂、耗时较长，建议将生成任务放到Celery等异步任务队列中执行，生成完成后通过消息通知用户下载，避免阻塞Django的请求响应 cycle。生成完成后可以将文件存储到指定路径，下载时直接读取文件即可。
PDF下载阶段的优化策略
实现断点续传功能
断点续传可以让用户在下载中断后，从已下载的位置继续下载，不需要重新获取整个文件。Django中实现断点续传的核心逻辑是处理Range请求头，返回对应的文件片段：
import os
from django.http import HttpResponse, HttpResponsePartialContent, Http404
def pdf_download_view(request, file_path):
# 检查文件是否存在
if not os.path.exists(file_path):
raise Http404("文件不存在")
file_size = os.path.getsize(file_path)
range_header = request.META.get('HTTP_RANGE', None)
# 如果没有Range头，返回完整文件
if not range_header:
with open(file_path, 'rb') as f:
response = HttpResponse(f.read(), content_type='application/pdf')
response['Content-Disposition'] = f'attachment; filename="{os.path.basename(file_path)}"'
response['Content-Length'] = file_size
return response
# 解析Range头，格式为 bytes=start-end
range_str = range_header.replace('bytes=', '')
start_str, end_str = range_str.split('-')
start = int(start_str) if start_str else 0
end = int(end_str) if end_str else file_size - 1
# 校验范围合法性
if start >= file_size or end >= file_size or start > end:
response = HttpResponse(status=416)
response['Content-Range'] = f'bytes */{file_size}'
return response
# 读取指定范围的文件内容
with open(file_path, 'rb') as f:
f.seek(start)
data = f.read(end - start + 1)
response = HttpResponsePartialContent(data, content_type='application/pdf')
response['Content-Disposition'] = f'attachment; filename="{os.path.basename(file_path)}"'
response['Content-Range'] = f'bytes {start}-{end}/{file_size}'
response['Content-Length'] = len(data)
return response
使用X-Sendfile提升下载效率
Apache支持X-Sendfile模块，可以让Apache直接处理文件传输，不需要Django读取文件内容再返回，大幅降低Django进程的资源占用。首先需要在Apache配置中启用X-Sendfile模块，然后在Django视图中设置对应的响应头：
from django.http import HttpResponse
import os
def pdf_xsendfile_download(request, file_path):
if not os.path.exists(file_path):
raise Http404("文件不存在")
response = HttpResponse()
response['Content-Type'] = 'application/pdf'
response['Content-Disposition'] = f'attachment; filename="{os.path.basename(file_path)}"'
# 设置X-Sendfile头，让Apache直接发送文件
response['X-Sendfile'] = file_path
return response
Apache服务器配置优化
除了Django代码层面的优化，还需要调整Apache的相关配置适配大文件处理：
- 调整
TimeOut参数，默认是60秒，大文件下载可以适当调大，比如设置为300秒，避免请求提前超时 - 启用
mod_deflate模块对PDF文件之外的静态资源做压缩，减少带宽占用，但注意PDF本身已经是压缩格式，不需要再压缩 - 调整
MaxRequestWorkers参数，避免过多并发大文件请求导致Apache资源耗尽 - 如果使用X-Sendfile，确保
mod_xsendfile模块已经正确安装和启用，并且配置中允许对应的文件目录被X-Sendfile访问
性能测试与验证
优化完成后可以通过ab等工具做压力测试，模拟多个用户同时下载大PDF文件，观察Django进程的内存占用、Apache的响应时间、下载成功率等指标，根据测试结果再调整对应的参数。同时可以测试断点续传功能，手动中断下载后重新请求，验证是否能从断点位置继续传输。