Docker容器中.NET Core应用初始化QuestPDF报错求解决方案

针对你遇到的QuestPDF在Linux Docker容器中启动时的依赖加载错误，可按以下步骤解决：

1. 确认项目已安装匹配版本的NuGet包 #

确保你的项目中已安装SkiaSharp.NativeAssets.Linux.NoDependencies和HarfBuzzSharp.NativeAssets.Linux，且版本与QuestPDF保持兼容。版本不匹配会直接导致原生库加载失败，建议使用与QuestPDF主版本对应的最新稳定版。

2. 修正Dockerfile的系统依赖配置 #

你当前的Dockerfile安装了musl-dev并创建软链接，但mcr.microsoft.com/dotnet/aspnet:6.0-bullseye-slim基于glibc构建，musl与glibc的C库冲突会导致SkiaSharp原生库无法正确加载。替换为以下Dockerfile配置：

FROM mcr.microsoft.com/dotnet/aspnet:6.0-bullseye-slim

RUN apt-get update && apt-get install -y --no-install-recommends \
    libfontconfig1 \
    libfreetype6 \
    libharfbuzz0b \
    libicu-dev \
    libpng16-16 \
    libssl1.1 \
    && rm -rf /var/lib/apt/lists/*

这些是SkiaSharp在Debian Bullseye环境下必需的系统依赖，能确保原生库正常加载。

3. 确保原生资产正确复制到容器 #

在项目的.csproj文件中添加以下配置，确保NuGet包中的原生库文件被正确复制到输出目录，从而在容器中能被程序找到：

<ItemGroup>
  <NativeAsset Include="$(OutputPath)/runtimes/linux-x64/native/*" />
</ItemGroup>

4. 调整QuestPDF初始化时机 #

避免在应用启动初期过早初始化QuestPDF（比如设置License），确保应用已完成依赖加载后再调用QuestPDF相关代码。例如在Program.cs中，可在构建完WebApplication之后再设置License：

var app = builder.Build();

// 其他中间件配置...

QuestPDF.Settings.License = QuestPDF.Infrastructure.LicenseType.Community;

app.Run();

错误原因说明 #

你遇到的System.ArgumentNullException: Value cannot be null. (Parameter 'asset')错误，本质是SkiaSharp无法找到正确的原生库文件，这是由于musl与glibc库冲突导致的。移除musl相关配置，改用glibc对应的系统依赖即可解决。

内容的提问来源于stack exchange，提问作者Björn Sturzrehm