在C#的DinkToPdf转换器中，页眉图片不显示的解决方法

针对你使用DinkToPdf时，通过HeaderSettings.HtmUrl加载本地HTML页眉但图片无法显示的问题，提供以下几种可行解决方案：

方案1：使用图片绝对路径并确保权限 #

DinkToPdf依赖的wkhtmltopdf对本地文件路径解析要求严格，需确保页眉HTML里的图片使用完整绝对路径，同时运行程序的进程要有读取图片文件的权限：

1. 修改Logo.htm中的图片引用：

<img src="C:\完整路径\Uploads\CompanyLogo\logo.png" alt="公司Logo" />

2. 检查权限：如果是IIS部署，确保应用池身份对C:\...\Uploads\CompanyLogo文件夹有读取权限；本地调试时，当前用户账户需有该路径的访问权限。

方案2：将页眉HTML与图片嵌入为Base64（推荐） #

把图片转成Base64编码直接嵌入页眉HTML，彻底避免路径和权限问题，同时无需依赖外部文件：

修改代码如下：

public string GeneratePdfReport(string htmlTemplate, string path, string headerTemplate, string auditBy)
{
    // 读取图片并转为Base64
    string logoPath = @"C:\完整路径\Uploads\CompanyLogo\logo.png";
    string logoBase64 = Convert.ToBase64String(File.ReadAllBytes(logoPath));
    
    // 构造包含Base64图片的页眉HTML
    string headerHtml = $@"
    <div style='text-align: left;'>
        <img src='data:image/png;base64,{logoBase64}' width='100' height='50' alt='Logo' />
    </div>";

    var globalSettings = new GlobalSettings
    {
        ColorMode = ColorMode.Color,
        Orientation = Orientation.Portrait,
        PaperSize = PaperKind.A4,
        Margins = new MarginSettings { Top = 20, Bottom = 20, Right = 10, Left = 10 },
        DocumentTitle = "PDF Report",
        Out = path
    };

    var objectSettings = new ObjectSettings
    {
        PagesCount = true,
        HtmlContent = htmlTemplate,
        WebSettings = { DefaultEncoding = "utf-8", PrintMediaType = true, LoadImages = true },
        // 改用HtmlContent传入页眉内容，而非HtmUrl
        HeaderSettings = { FontName = "Arial", FontSize = 9, Line = true, HtmlContent = headerHtml },
        FooterSettings = { FontName = "Arial", FontSize = 9, Line = true, Right = "Page [page]", Left = auditBy }
    };

    var pdf = new HtmlToPdfDocument()
    {
        GlobalSettings = globalSettings,
        Objects = { objectSettings }
    };

    _converter.Convert(pdf);
    return path;
}

方案3：配置资源加载根路径 #

如果坚持使用HtmUrl加载页眉HTML，可以通过WebSettings.ResourcePath指定资源根目录，让wkhtmltopdf自动从该目录加载图片：

1. 修改代码中的WebSettings：

var objectSettings = new ObjectSettings
{
    PagesCount = true,
    HtmlContent = htmlTemplate,
    WebSettings = { 
        DefaultEncoding = "utf-8", 
        PrintMediaType = true, 
        LoadImages = true,
        // 设置页眉HTML所在文件夹为资源根路径
        ResourcePath = @"C:\完整路径\Uploads\CompanyLogo\" 
    },
    HeaderSettings = { FontName = "Arial", FontSize = 9, Line = true, HtmUrl = @"C:\完整路径\Uploads\CompanyLogo\Logo.htm" },
    FooterSettings = { FontName = "Arial", FontSize = 9, Line = true, Right = "Page [page]", Left = auditBy }
};

2. 修改Logo.htm中的图片引用为相对路径：

<img src="logo.png" alt="公司Logo" />

额外注意事项 #

• 确保使用最新稳定版的DinkToPdf和对应的wkhtmltopdf，旧版本可能存在本地资源加载的兼容性问题。
• 避免将文件放在C盘根目录等系统受保护路径，尽量使用网站根目录下的自定义文件夹，权限配置更简单。

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