Django怎么生成PDF报告_Python使用ReportLab库渲染HTML内容

经常碰到的错误是 ValueError: Unknown tag: div，或者排版完全错乱。

• 只是简单加个粗、换个行，用 Paragraph('标题
正文', style) 倒也还行
• 但只要涉及布局、浮动、边距、字体大小混用，这条路基本就走不通了
• 别指望给 Paragraph 传一段从 Django 模板 render 出来的完整 HTML —— 它不是浏览器

Django 中生成 PDF 的实际可行路径

行业里的主流做法是“HTML → PDF”：先用 Django 渲染出标准的 HTML 字符串，再交给真正能解析 HTML 的工具去转成 PDF。到了这一步，ReportLab 就不太合适了，得换个工具。

推荐两套组合：WeasyPrint（纯 Python，支持 CSS3、@media print、flex）和 pdfkit（封装了 wkhtmltopdf，更成熟但需要额外装一个二进制依赖）。

• WeasyPrint 安装简单，一行 pip install WeasyPrint 就行，没有系统依赖的烦恼
• pdfkit 需要在本地装 wkhtmltopdf，在 Docker 或者某些云环境里，这一步容易卡住
• 两者都支持传入字符串或文件路径，可以直接跟 render_to_string('report.html', context) 无缝对接
• 别忘了在 CSS 里设置 @page { size: A4; margin: 1cm; }，否则默认输出可能会裁切掉一部分内容

用 WeasyPrint 在 Django 视图里生成 PDF

关键不是“怎么调 ReportLab”，而是绕过它，用更贴合场景的工具把 HTML 稳稳地转成 PDF。

来看一个实际可跑的片段：

from weasyprint import HTML
from django.http import HttpResponse
from django.template.loader import render_to_string

def report_pdf(request):
    context = {'data': [...]}
    html_string = render_to_string('report.html', context)
    html = HTML(string=html_string, base_url=request.build_absolute_uri('/'))
    response = HttpResponse(content_type='application/pdf')
    response['Content-Disposition'] = 'attachment; filename="report.pdf"'
    html.write_pdf(response)
    return response

这里 base_url 非常关键。没有它，weasyprint 找不到静态资源（CSS、字体、图片），结果就是白底黑字、没样式、缺图标。

• CSS 文件必须用 {% static %} 来引用，并且确保 STATIC_ROOT 已经收集完毕；或者干脆改用内联的