AKS容器因Aspose生成PDF崩溃：SkiaSharp依赖缺失求助

异常信息 #

Unhandled exception. System.TypeInitializationException: The type initializer for 'SkiaSharp.SKObject' threw an exception.
 ---> System.DllNotFoundException: Unable to load shared library 'libSkiaSharp' or one of its dependencies. In order to help diagnose loading problems, consider using a tool like strace. If you're using glibc, 
    consider setting the LD_DEBUG environment variable:
    /lib64/libm.so.6: version `GLIBC_2.29' not found (required by /app/runtimes/linux-x64/native/libSkiaSharp.so)
    /usr/lib64/dotnet/shared/Microsoft.NETCore.App/8.0.12/libSkiaSharp.so: cannot open shared object file: No such file or directory
    /app/libSkiaSharp.so: cannot open shared object file: No such file or directory
    /app/runtimes/linux-x64/native/liblibSkiaSharp.so: cannot open shared object file: No such file or directory
    /usr/lib64/dotnet/shared/Microsoft.NETCore.App/8.0.12/liblibSkiaSharp.so: cannot open shared object file: No such file or directory
    /app/liblibSkiaSharp.so: cannot open shared object file: No such file or directory
    /app/runtimes/linux-x64/native/libSkiaSharp: cannot open shared object file: No such file or directory
    /usr/lib64/dotnet/shared/Microsoft.NETCore.App/8.0.12/libSkiaSharp: cannot open shared object file: No such file or directory
    /app/libSkiaSharp: cannot open shared object file: No such file or directory
    /app/runtimes/linux-x64/native/liblibSkiaSharp: cannot open shared object file: No such file or directory
    /usr/lib64/dotnet/shared/Microsoft.NETCore.App/8.0.12/liblibSkiaSharp: cannot open shared object file: No such file or directory
    /app/liblibSkiaSharp: cannot open shared object file: No such file or directory
    
       at SkiaSharp.SkiaApi.sk_version_get_milestone()
       at SkiaSharp.SkiaSharpVersion.get_Native()
       at SkiaSharp.SkiaSharpVersion.CheckNativeLibraryCompatible(Boolean throwIfIncompatible)
       at SkiaSharp.SKObject..cctor()
       --- End of inner exception stack trace ---
       at SkiaSharp.SKObject.DeregisterHandle(IntPtr handle, SKObject instance)
       at SkiaSharp.SKObject.set_Handle(IntPtr value)
       at SkiaSharp.SKNativeObject.Dispose(Boolean disposing)
       at SkiaSharp.SKObject.Dispose(Boolean disposing)
       at SkiaSharp.SKBitmap.Dispose(Boolean disposing)
       at SkiaSharp.SKNativeObject.Finalize()

核心原因 #

核心问题：libSkiaSharp.so依赖的GLIBC_2.29版本在AKS Pod所使用的基础镜像中缺失，导致SkiaSharp初始化失败，进而引发Aspose.PDF生成PDF时的Pod崩溃。

解决方案 #

• 使用兼容GLIBC版本的基础镜像
  替换现有Docker镜像为包含GLIBC 2.29及以上版本的.NET基础镜像，例如基于Debian 12（Bookworm）的官方镜像：

  FROM mcr.microsoft.com/dotnet/aspnet:8.0-bookworm-slim
  

  Debian 12及以上、Ubuntu 20.04+等发行版的GLIBC版本均满足libSkiaSharp.so的依赖要求。

• 手动在旧镜像中安装GLIBC 2.29
  若必须使用旧基础镜像（如Alpine），可通过多阶段构建手动部署兼容版本的GLIBC：

  # 阶段1：下载GLIBC 2.29安装包
  FROM alpine:3.12 as glibc-builder
  RUN apk add --no-cache wget
  RUN wget https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.29-r0/glibc-2.29-r0.apk
  RUN wget https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.29-r0/glibc-bin-2.29-r0.apk
  RUN apk add --no-cache glibc-2.29-r0.apk glibc-bin-2.29-r0.apk
  
  # 阶段2：构建应用镜像
  FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine
  COPY --from=glibc-builder /usr/glibc-compat /usr/glibc-compat
  ENV LD_LIBRARY_PATH="/usr/glibc-compat/lib:$LD_LIBRARY_PATH"
  # 复制应用发布文件
  COPY ./publish /app
  WORKDIR /app
  ENTRYPOINT ["dotnet", "YourApplication.dll"]
  

• 使用静态编译的SkiaSharp包
  在项目中安装SkiaSharp.NativeAssets.Linux.NoDependencies，该包包含静态编译的libSkiaSharp，完全不依赖系统GLIBC：

  dotnet add package SkiaSharp.NativeAssets.Linux.NoDependencies
  

  安装后重新构建应用，部署到AKS后即可自动使用静态版本的库，避免依赖问题。

• 禁用Aspose.PDF的SkiaSharp渲染（可选）
  部分Aspose.PDF版本支持切换渲染引擎，尝试关闭SkiaSharp依赖：

  var doc = new Aspose.Pdf.Document("input.pdf");
  var renderOptions = new Aspose.Pdf.RenderingOptions();
  renderOptions.UseSkia = false;
  // 执行PDF生成操作
  doc.Save("output.pdf");
  

  注意：此方法可能影响部分复杂PDF元素的渲染效果，需提前测试验证。

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