Django使用pdfkit转换受保护网页为PDF时图片无法嵌入问题

嘿，我懂这种闹心的感觉——网页明明显示正常，转成PDF就丢了图片还报file路径加载失败的警告。别慌，咱们来一步步搞定它：

最靠谱的解决方案：指定base_url参数 #

你用from_string方法的时候，pdfkit拿到的只是纯HTML字符串，它根本不知道这些相对路径的图片该从哪里找。这时候给它指定一个base_url就能解决核心问题，让pdfkit明确资源的根目录：

from django.conf import settings
import pdfkit

# 如果你用的是本地媒体文件路径，直接传MEDIA_ROOT的绝对路径
base_url = settings.MEDIA_ROOT
# 要是你的媒体文件是通过HTTP服务访问的（比如开发服务器的http://localhost:8000/media/），也可以用完整的HTTP URL
# base_url = f"{settings.SITE_URL}{settings.MEDIA_URL}"

pdfkit.from_string(msg_html, 'testing123.pdf', options={'base_url': base_url})

原理很简单：base_url会作为所有相对路径资源的解析基准，pdfkit就能正确定位到/media/images/main/logo.jpg对应的实际文件了。

备选方案：替换HTML中的图片路径为绝对file路径 #

如果你不想用base_url，也可以在生成msg_html的时候，把图片的相对路径直接替换成完整的file协议路径：

from django.conf import settings
import os

# 构造图片的绝对file路径
logo_path = os.path.join(settings.MEDIA_ROOT, 'images/main/logo.jpg')
logo_file_url = f"file://{logo_path}"

# 替换HTML中的图片路径
msg_html = msg_html.replace('/media/images/main/logo.jpg', logo_file_url)

# 再生成PDF
pdfkit.from_string(msg_html, 'testing123.pdf')

不过这个方法需要你逐个替换HTML里的图片路径，灵活性不如第一个方案。

额外检查点 #

• 文件权限：确保运行Django的进程（比如uWSGI、开发服务器）有读取media目录下图片文件的权限，权限不足也会导致加载失败。
• wkhtmltopdf版本：pdfkit是基于wkhtmltopdf的，旧版本的wkhtmltopdf对file协议路径的处理可能有bug，建议更新到最新稳定版。

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