DinkToPDF生产环境加载libwkhtmltox失败，求解决方案或.NET6替代库

一、DinkToPDF生产环境问题排查与解决 #

1. 安装系统依赖库 #

生产环境（Linux）下wkhtmltox依赖多个系统共享库，缺失会导致加载失败。以Debian/Ubuntu为例，执行以下命令安装依赖：

sudo apt-get update && sudo apt-get install -y libfontconfig1 libx11-6 libxext6 libxrender1 libjpeg62-turbo libpng16-16 libglib2.0-0 libpango-1.0-0 libpangocairo-1.0-0 libcairo2 libgdk-pixbuf2.0-0

如果是CentOS/RHEL，使用yum命令安装对应包：

sudo yum install -y fontconfig libX11 libXext libXrender libjpeg-turbo libpng glib2 pango cairo gdk-pixbuf2

2. 确认库文件路径并指定加载路径 #

• 检查发布目录：登录生产服务器，确认libwkhtmltox.so是否存在于应用程序的输出目录（比如bin/Release/net6.0/publish/）。
• 代码中指定库路径：在初始化Converter之前，手动设置库的绝对路径，避免系统找不到：

// 替换为生产环境中libwkhtmltox.so的实际路径
WKHtmlToXConverter.SetLibraryPath("/var/www/yourapp/libwkhtmltox.so");
var converter = new SynchronizedConverter(new PdfTools());

3. Docker部署额外配置 #

如果用Docker部署，需要在Dockerfile中添加依赖安装和文件复制步骤：

FROM mcr.microsoft.com/dotnet/aspnet:6.0

# 安装系统依赖
RUN apt-get update && apt-get install -y libfontconfig1 libx11-6 libxext6 libxrender1 libjpeg62-turbo libpng16-16 libglib2.0-0 libpango-1.0-0 libpangocairo-1.0-0 libcairo2 libgdk-pixbuf2.0-0

# 复制应用程序文件
WORKDIR /app
COPY ./publish .

# 复制libwkhtmltox.so到容器内（如果本地已包含在发布目录，此步可省略）
COPY ./libwkhtmltox.so /app/libwkhtmltox.so

ENTRYPOINT ["dotnet", "YourApp.dll"]

二、.NET6下MIT协议的HTML转PDF替代库 #

1. PuppeteerSharp #

• 基于Chrome无头浏览器，支持现代HTML/CSS特性，渲染效果接近真实浏览器。
• MIT协议，需要依赖Chrome/Chromium，部署时需确保环境中有对应浏览器，或使用预安装浏览器的Docker镜像。
• 示例代码：

using PuppeteerSharp;

var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });
var page = await browser.NewPageAsync();
await page.SetContentAsync("<h1>Hello PDF</h1>");
await page.PdfAsync("output.pdf");
await browser.CloseAsync();

2. HtmlRenderer.PdfSharpCore #

• 轻量级库，基于PdfSharp，无需外部浏览器依赖，适合简单HTML场景。
• MIT协议，对复杂CSS支持有限，但部署简单。
• 示例代码：

using TheArtOfDev.HtmlRenderer.PdfSharp;

var pdf = PdfGenerator.GeneratePdf("<h1>Hello PDF</h1>", PdfSharp.PageSize.A4);
pdf.Save("output.pdf");

3. QuestPDF #

• 注意：并非直接转换HTML，而是通过C# API声明式构建PDF文档。
• MIT协议，完全无外部依赖，渲染效果可控，适合需要自定义PDF布局的场景。
• 示例代码：

using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Content().Text("Hello PDF").FontSize(20);
    });
}).GeneratePdf("output.pdf");

内容的提问来源于stack exchange，提问作者hanushi-thana