Docker Linux容器中DevExpress Reports生成PDF时SKFontManager异常求助

在Docker Linux容器中使用DevExpress Reports生成PDF文件时，出现以下报错：

The type initializer for 'SkiaSharp.SKFontManager' threw an exception.

Windows环境运行正常，但部署到Linux容器后问题持续。已尝试安装libfontconfig1、libfreetype6等依赖，执行过以下命令：

apt-get update && \
apt-get install -yq nodejs && \
apt-get install -yq nodejs libfontconfig1 libfreetype6 && \
rm -rf /var/lib/apt/lists/*

apt update && \
apt install -y libc6 && \
apt install -y libgcc1 && \
apt install -y libgssapi-krb5-2 && \
apt install -y libicu66 && \
apt install -y libssl1.1 && \
apt install -y libfontconfig1 && \
apt install -y libicu-dev && \
apt install -y libjpeg-turbo8 && \
apt install -y libstdc++6 && \
apt install -y zlib1g && \
apt install -y gnupg ca-certificates && \

升级到.NET 7后，通过XtraReport实例加载PDF布局时，错误仍然存在。

• 安装SkiaSharp Linux适配包：DevExpress Reports依赖SkiaSharp渲染，需确保项目中安装了SkiaSharp.NativeAssets.Linux.NoDependencies（推荐，包含预编译的Linux原生库）或SkiaSharp.NativeAssets.Linux包。可通过NuGet包管理器添加，或执行命令：

  dotnet add package SkiaSharp.NativeAssets.Linux.NoDependencies
  

• 补充系统字体文件：Linux容器默认缺少基础字体，会导致SKFontManager初始化失败。安装常用字体包：

  apt-get update && apt-get install -y fonts-dejavu-core fonts-liberation && rm -rf /var/lib/apt/lists/*
  

  安装完成后执行fc-cache -fv更新字体缓存。

• 指定SkiaSharp原生库路径：若容器中SkiaSharp的.so文件未被自动识别，在Dockerfile中设置环境变量指向库的位置：

  ENV SKIASHP_LIBRARY_PATH=/app/runtimes/linux-x64/native/libSkiaSharp.so
  

  路径需根据项目实际发布后的文件位置调整。

• 使用完整的.NET基础镜像：避免使用过于精简的镜像，推荐使用mcr.microsoft.com/dotnet/aspnet:7.0-bookworm-slim作为基础镜像，它包含更多预安装的系统依赖。

• 捕获内部异常定位根因：在代码中添加异常捕获，输出内部错误信息，明确是依赖缺失还是字体问题：

  try
  {
      var report = new XtraReport();
      // 加载布局、生成PDF的逻辑
      report.ExportToPdf("output.pdf");
  }
  catch (TypeInitializationException ex)
  {
      Console.WriteLine($"详细错误：{ex.InnerException?.Message}");
      Console.WriteLine($"错误堆栈：{ex.InnerException?.StackTrace}");
  }
  

• 验证依赖完整性：在容器中执行ldd /app/runtimes/linux-x64/native/libSkiaSharp.so（替换为实际路径），检查是否有缺失的系统库，根据结果补充安装对应的依赖包。

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