如何修复Azure App Service无法加载DLL 'libwkhtmltox'或其依赖项的问题

这个BadImageFormatException错误本质是加载的原生库架构和当前运行环境不匹配，或者对应平台的原生库不存在，结合你当前的配置，按以下步骤调整即可解决：

• 补齐对应平台的原生库文件
  你当前只在项目中包含了Windows平台的libwkhtmltox.dll，如果你部署的是Linux/OSX环境的Azure App Service，对应需要的.so/.dylib文件根本没有被打包到部署包中。请先下载对应你部署环境架构（x86/x64/ARM）的三个平台原生库，放到项目的wkhtmltox文件夹下。
• 修正.csproj配置
  你当前的配置仅针对Windows的dll，且用EmbeddedResource不是最优选择，修改为以下配置，确保所有平台的原生库都被复制到输出目录：

<ItemGroup>
  <Content Include="wkhtmltox/*" CopyToOutputDirectory="Always" />
</ItemGroup>

该配置会自动将wkhtmltox文件夹下的所有文件都复制到输出目录，无需单独指定每个文件，也避免了Windows反斜杠路径在Linux环境下的适配问题。

• 匹配运行环境架构
  • 如果你部署的是Windows环境的Azure App Service：进入Azure门户的App Service配置页，在「常规设置」中检查「平台」选项，如果你使用的是64位的libwkhtmltox.dll，请将平台设置为64位，默认Azure会启用32位平台，架构不匹配就会触发你遇到的格式错误。
  • 如果你部署的是Linux环境的Azure App Service：首先确认你使用的libwkhtmltox.so和Azure环境的CPU架构匹配（大部分Azure Linux实例是x64架构），其次需要在启动命令中安装libwkhtmltox的运行依赖，在Azure配置的「启动命令」栏填入：

  apt-get update && apt-get install -y libfontconfig1 libjpeg62-turbo libpng16-16 && dotnet 你的项目启动文件名.dll
  

• 增加路径校验逻辑
  在加载原生库前增加文件存在判断，避免路径拼接错误导致的加载失败：

var wkHtmlToPdfPath = Path.Combine(Directory.GetCurrentDirectory(), "wkhtmltox", wkHtmlToPdfFileDllName);
// 增加以下校验逻辑，可自行添加日志打印实际路径排查问题
if (!File.Exists(wkHtmlToPdfPath))
{
    throw new FileNotFoundException("libwkhtmltox原生库不存在", wkHtmlToPdfPath);
}
CustomAssemblyLoadContext context = new CustomAssemblyLoadContext();
context.LoadUnmanagedLibrary(wkHtmlToPdfPath);
services.AddSingleton(typeof(IConverter), new SynchronizedConverter(new PdfTools()));

• 可选优化：如果调整后仍然加载失败，可以尝试将wkhtmltox文件夹的绝对路径添加到系统环境变量PATH中，跳过显式加载原生库的步骤：

var wkHtmlToPdfFolder = Path.Combine(Directory.GetCurrentDirectory(), "wkhtmltox");
Environment.SetEnvironmentVariable("PATH", $"{Environment.GetEnvironmentVariable("PATH")};{wkHtmlToPdfFolder}");
services.AddSingleton(typeof(IConverter), new SynchronizedConverter(new PdfTools()));

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