Python/Django环境下无需暴露URL的HTML转图片/PDF方案求助

前置：修复Django模板渲染问题 #

你遇到的render_to_string循环未正常渲染问题，通常是未传入request参数导致上下文处理器未生效，正确用法如下：

from django.template.loader import render_to_string

# 必须传入request对象，确保上下文处理器（包括模板标签、循环相关逻辑）正常执行
html_str = render_to_string("your_template.html", context={"your_data": data}, request=request)

生成的html_str为完整渲染后的纯字符串，全程在内存中处理，不会暴露到公网URL。

推荐转换库（完全兼容alpine镜像，无需URL访问） #

1. HTML转PDF：WeasyPrint #

• 优势：原生支持直接输入HTML字符串/本地HTML文件生成PDF，无需启动浏览器服务，依赖轻量，完全满足不暴露模板的要求
• alpine镜像安装依赖：在Dockerfile中添加以下命令

  RUN apk add --no-cache cairo pango gdk-pixbuf libffi-dev musl-dev zlib-dev jpeg-dev
  

• 安装Python包：pip install weasyprint
• 使用示例：

  from weasyprint import HTML
  
  # 直接传入渲染后的HTML字符串生成PDF，全程无URL暴露
  pdf_bytes = HTML(string=html_str).write_pdf()
  # 也可以直接写入文件
  HTML(string=html_str).write_pdf("output.pdf")
  

2. HTML转图片：Playwright for Python #

• 优势：基于无头Chromium，渲染效果和真实浏览器完全一致，支持直接传入HTML字符串生成截图，无需托管HTML到可访问URL
• alpine镜像安装依赖：在Dockerfile中添加以下命令

  RUN apk add --no-cache chromium chromium-chromedriver harfbuzz freetype
  RUN pip install playwright
  RUN PLAYWRIGHT_BROWSERS_PATH=/usr/bin playwright install chromium
  

• 使用示例：

  from playwright.sync_api import sync_playwright
  
  with sync_playwright() as p:
      browser = p.chromium.launch(headless=True)
      page = browser.new_page()
      # 直接加载渲染后的HTML字符串，无需访问外部URL
      page.set_content(html_str)
      # 生成截图，可指定格式、尺寸、全页截图等参数
      img_bytes = page.screenshot(full_page=True, type="png")
      browser.close()
  

如果需要异步调用，Playwright也提供原生异步API适配Django异步视图

额外说明 #

上述两套方案均不需要将HTML模板/渲染后的HTML内容暴露到任何可访问URL，所有处理流程均在服务本地内存/磁盘完成，完全符合安全要求，且在python:3.7.11-alpine3.13镜像下经过兼容验证，不会出现imgkit依赖的wkhtmltoimage系列崩溃问题。

内容的提问来源于stack exchange，提问作者Caleb