使用xhtml2pdf从HTML模板生成PDF时图片不显示的问题求助

我之前也踩过这个坑！当用Django模板渲染生成PDF时，直接用{% static %}标签输出的相对路径，PDF渲染引擎（比如xhtml2pdf、wkhtmltopdf这类）通常无法正确解析——因为它们不像浏览器那样能自动识别站点的静态文件根目录。下面给你几个可行的解决方案：

方案1：传递图片的完整绝对URL到模板 #

修改你的视图代码，把图片的完整可访问URL传给模板，这样PDF渲染器能直接通过URL拉取图片：

class GeneratePdf_month(TemplateView):
    template_name = "polls/info_month.html"
    def get(self, request, *args, **kwargs):
        # 原有逻辑保持不变
        cliente = # 你的cliente获取逻辑
        # 生成图片的完整绝对URL
        from django.templatetags.static import static
        image_static_path = static('polls/images/image.png')
        image_full_url = request.build_absolute_uri(image_static_path)
        
        data = { 
            'cliente': cliente, 
            'image_full_url': image_full_url  # 把URL加入数据
        }
        pdf = render_to_pdf(self.template_name, data)
        return HttpResponse(pdf, content_type='application/pdf')

然后修改HTML模板里的图片引用：

<header>BlaBla<img src="{{ image_full_url }}"></header>

方案2：传递图片的本地绝对文件路径（适合无网络环境） #

如果你的PDF生成不需要依赖外部网络，可以直接传递图片在服务器上的绝对文件路径，PDF渲染器支持通过file://协议读取本地文件：

class GeneratePdf_month(TemplateView):
    template_name = "polls/info_month.html"
    def get(self, request, *args, **kwargs):
        cliente = # 你的cliente获取逻辑
        # 获取图片的本地绝对路径
        import os
        from django.conf import settings
        image_abs_path = os.path.join(settings.STATIC_ROOT, 'polls/images/image.png')
        # 处理Windows路径的转义问题（如果是Linux服务器可以忽略）
        image_abs_path = image_abs_path.replace('\\', '/')
        
        data = { 
            'cliente': cliente, 
            'image_abs_path': image_abs_path
        }
        pdf = render_to_pdf(self.template_name, data)
        return HttpResponse(pdf, content_type='application/pdf')

模板里修改为：

<header>BlaBla<img src="file://{{ image_abs_path }}"></header>

额外注意事项 #

• 如果你在生产环境，务必先运行python manage.py collectstatic，确保所有静态文件都被收集到STATIC_ROOT指定的目录下，否则绝对路径会找不到文件。
• 检查PDF渲染库的权限：确保运行Django的进程有读取静态文件目录的权限。
• 确认STATIC_URL和STATIC_ROOT在settings.py里配置正确，比如：

  STATIC_URL = '/static/'
  STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
  

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