Docker Compose中Syncfusion HtmlToPdf转换器报Blink文件缺失错误求助

出现Syncfusion.Pdf.PdfException: 'Blink files are missing'错误，核心原因是Docker容器内缺少Syncfusion依赖的Blink原生库文件，或者系统无法定位这些文件路径。以下是具体解决步骤：

1. 修正Dockerfile，确保Blink文件被正确复制 #

使用多阶段构建时，需在发布阶段将NuGet包中的Blink原生文件复制到容器运行目录，同时安装依赖系统库并配置环境变量：

# 构建阶段
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["YourProject.csproj", "."]
RUN dotnet restore "./YourProject.csproj"
COPY . .
RUN dotnet build "YourProject.csproj" -c Release -o /app/build

# 发布阶段
FROM build AS publish
RUN dotnet publish "YourProject.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 运行阶段
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
# 安装Blink依赖的系统基础库
RUN apt-get update && apt-get install -y --no-install-recommends \
    libx11-6 libxcomposite1 libxcursor1 libxdamage1 libxext6 \
    libxfixes3 libxi6 libxrandr2 libxrender1 libglib2.0-0 \
    libnss3 libcups2 libdbus-1-3 libatk1.0-0 libatk-bridge2.0-0 libgtk-3-0

WORKDIR /app
COPY --from=publish /app/publish .
# 复制Syncfusion的Blink原生文件到容器内指定目录
COPY --from=build /root/.nuget/packages/syncfusion.htmltopdfconverter.net.linux/21.2.9/lib/netstandard2.0/runtimes/linux/native/* /app/runtimes/linux/native/
# 配置系统库路径，让程序能找到Blink文件
ENV LD_LIBRARY_PATH=/app/runtimes/linux/native:$LD_LIBRARY_PATH

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

注意替换YourProject为实际项目名称，21.2.9为你使用的Syncfusion包版本。

2. 配置项目文件，确保Blink文件随发布复制 #

在项目的.csproj中添加以下配置，让Blink原生文件在发布时自动复制到输出目录：

<ItemGroup>
  <None Include="$(NuGetPackageRoot)syncfusion.htmltopdfconverter.net.linux/21.2.9/lib/netstandard2.0/runtimes/linux/native/*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </None>
</ItemGroup>

3. （可选）代码中手动指定Blink路径 #

如果上述步骤仍无法解决问题，可在代码中显式指定Blink库的路径：

[HttpGet]
public IActionResult UrlToPdf()
{
    HtmlToPdfConverter htmlConverter = new HtmlToPdfConverter();
    BlinkConverterSettings settings = new BlinkConverterSettings();
    // 替换为容器内Blink文件的实际存放路径
    settings.BlinkPath = "/app/runtimes/linux/native";
    htmlConverter.ConverterSettings = settings;

    PdfDocument document = htmlConverter.Convert("https://www.google.com");
    MemoryStream stream = new MemoryStream();
    document.Save(stream);
    document.Close(true);

    return File(stream.ToArray(), System.Net.Mime.MediaTypeNames.Application.Pdf, "HTML-to-PDF.pdf");          
}

4. 验证解决效果 #

重新构建Docker镜像，启动容器后调用/v5/pdf-generate接口，检查是否能正常生成PDF文件。

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