使用pdfkit转换HTML到PDF时本地图片访问被阻止，如何使用本地图片？

这个问题我之前也碰到过，本质是wkhtmltopdf（pdfkit背后依赖的渲染工具）默认开启了本地文件访问的安全限制，防止恶意HTML读取本地敏感文件，所以会阻止加载本地图片资源。下面给你几个可行的解决方案：

方案1：修改pdfkit配置，允许本地文件访问 #

最简单的方法就是在初始化pdfkit时，添加enable-local-file-access选项，直接禁用这个安全限制。

Python代码示例： #

import pdfkit

# 配置选项，允许本地文件访问
config_options = {
    'enable-local-file-access': ''
}

# 转换HTML到PDF
pdfkit.from_file('your_input.html', 'output.pdf', options=config_options)

如果是直接使用wkhtmltopdf命令行工具，只需在命令中加上--enable-local-file-access参数即可：

wkhtmltopdf --enable-local-file-access your_input.html output.pdf

方案2：使用绝对路径或file://协议指定图片 #

有时候即使开启了权限，相对路径可能因为wkhtmltopdf的工作目录问题无法被正确识别。这时候可以把HTML中的图片src改成绝对路径，或者使用file://协议指定文件位置：

HTML示例： #

<!-- Linux/macOS绝对路径 -->
<img src="file:///home/your_user/images/photo.png" alt="Local image">

<!-- Windows绝对路径（注意三个斜杠） -->
<img src="file:///C:/Users/your_user/Pictures/photo.jpg" alt="Local image">

这样wkhtmltopdf能直接定位到图片文件，避免路径解析错误。

方案3：将图片转为Base64嵌入HTML（无外部依赖） #

如果不想修改pdfkit配置，也可以把本地图片转换成Base64编码，直接嵌入到HTML的img标签中。这样HTML完全不依赖外部文件，自然不会触发访问限制。

步骤示例： #

1. 先把本地图片转为Base64字符串（Python代码）：

import base64

# 读取图片并编码
with open('your_image.jpg', 'rb') as img_file:
    base64_data = base64.b64encode(img_file.read()).decode('utf-8')

# 生成可嵌入HTML的src字符串
img_src = f'data:image/jpeg;base64,{base64_data}'

2. 在HTML中使用这个Base64字符串：

<img src="{img_src}" alt="Embedded local image">

额外注意事项 #

• 确保运行pdfkit的用户拥有本地图片文件的读取权限，否则即使开启了访问限制，也会因为权限不足加载失败。
• 如果是在Web框架（如Flask/Django）中生成HTML模板，建议结合Base64方案，避免路径依赖问题。

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