Linux Docker容器中Spire.XLS转PDF类型初始化异常求助

问题描述 #

本地Windows环境运行正常的Excel转PDF代码，部署到Debian 12 Bookworm的.NET 8 Docker容器时，抛出以下异常：

[14:41:20 ERR] [ExcelService] Error trying to generate PDF agreement :
System.TypeInitializationException: The type initializer for
'Spire.Xls.Core.Spreadsheet.XlsPageSetupBase' threw an exception.

已安装的NuGet包：

• FreeSpire.XLS @ 14.2.0
• SkiaSharp.NativeAssets.Lunix.NoDependencies @ 3.116.1
• Spire.Officefor.NETStandard @ 10.2.0

解决方法 #

1. 调整NuGet包依赖版本 #

• 移除Spire.Officefor.NETStandard和SkiaSharp.NativeAssets.Lunix.NoDependencies，仅保留FreeSpire.XLS。FreeSpire.XLS本身已包含跨平台渲染所需的依赖，版本冲突是初始化失败的常见原因。
• 若必须保留Spire.Office，需保证FreeSpire.XLS与Spire.Office版本兼容：Spire.Office 10.x对应FreeSpire.XLS的10.x版本，而非当前的14.x，需降级FreeSpire.XLS到匹配版本。

2. 安装容器缺失的系统依赖 #

Debian 12默认缺少FreeSpire.XLS渲染PDF所需的系统库，在Dockerfile中添加以下命令：

apt-get update && apt-get install -y libfontconfig1 libc6 libgdiplus libx11-6

这些库是SkiaSharp和Spire组件在Linux下渲染图形、处理字体的必需依赖。

3. 修改代码初始化逻辑 #

在加载Workbook前添加环境配置，同时调整工作表访问顺序：

public byte[] CreatePdfReport()
{
    // 注册编码提供者
    System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance);
    // 设置Linux字体配置路径（适配容器环境）
    System.Environment.SetEnvironmentVariable("FONTCONFIG_PATH", "/etc/fonts");

    using (var excelStream = new MemoryStream(_package))
    {
        var workbook = new Workbook();
        workbook.LoadFromStream(excelStream);

        Worksheet sheet = workbook.Worksheets[0];
        sheet.Activate(); // 先激活工作表再访问PageSetup
        sheet.PageSetup.FitToPagesWide = 1;
        sheet.PageSetup.FitToPagesTall = 0;

        using (var pdfStream = new MemoryStream())
        {
            workbook.SaveToStream(pdfStream, FileFormat.PDF);
            return pdfStream.ToArray();
        }
    }
}

4. 更换Docker基础镜像 #

避免使用alpine镜像（缺少部分系统库，兼容性差），改用官方.NET 8 slim镜像：

FROM mcr.microsoft.com/dotnet/aspnet:8.0-bookworm-slim AS base
WORKDIR /app
EXPOSE 80

# 后续构建步骤...

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