Django怎么生成PDF报告_Python使用ReportLab库渲染HTML内容
Django生成PDF时，ReportLab仅支持有限HTML标签，无法完整渲染。建议改用WeasyPrint或pdfkit，通过HTML字符串转换PDF。需正确设置base_url、CSS样式及中文字体，避免乱码。
不能。ReportLab原生不支持完整HTML解析，仅识别等有限标签，遇、CSS或自定义class会报错；Django中生成PDF应改用WeasyPrint或pdfkit等真正支持HTML/CSS的工具。
在Django里生成PDF这事儿，问的人确实不少。很多朋友第一反应就是拿ReportLab来干，毕竟它名气大、文档全。但如果你试图让它直接渲染一段完整的HTML，那基本是撞南墙。可以负责任地讲：这条路，走不通。
ReportLab 能直接渲染 HTML 吗？
不能。
ReportLab原生并不支持完整的 HTML 解析。SimpleDocTemplate和Paragraph只认那么几个内联标签，比如、、。一旦遇到、CSS 样式或者自定义 class，它会直接报错或者干脆忽略掉。
经常碰到的错误是
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已经收集完毕；或者干脆改用内联的
