使用pdfkit将图片转为PDF时遇ProtocolUnknownError错误，如何解决？

这个错误的核心原因是：wkhtmltopdf会将相对路径的图片视为网络请求，但它无法识别本地文件的相对路径协议，因此抛出ProtocolUnknownError。以下是几种可行的解决方法：

方法一：使用file://协议+绝对路径（推荐） #

通过Python的os模块获取图片的绝对路径，转换为wkhtmltopdf能识别的file://协议格式：

import os
import pdfkit

# 获取图片的绝对路径
img_abs_path = os.path.abspath("static/images/image.png")
# 适配不同系统的路径分隔符，转换为file://格式
img_file_url = f"file:///{img_abs_path.replace(os.sep, '/')}"

result = f"""
    <h1>Image</h1>
    <img src="{img_file_url}">
    """

pdfkit.from_string(result, "static/images/foo.pdf")

这种方式跨Windows、Linux、macOS平台都能正常工作，自动处理路径中的空格和特殊字符问题。

方法二：直接使用绝对路径 #

如果你的运行环境路径规则简单，也可以直接写图片的完整绝对路径：

result = """
    <h1>Image</h1>
    <img src="/your/full/path/to/static/images/image.png">
    """
pdfkit.from_string(result, "static/images/foo.pdf")

注意：这种方式在Windows系统中需要使用类似C:/path/to/image.png的格式，且路径中有空格时可能需要额外处理，兼容性不如方法一。

方法三：检查wkhtmltopdf版本 #

如果以上方法无效，建议升级到wkhtmltopdf的最新稳定版本，旧版本可能存在本地文件路径解析的bug。

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