.NET 6 Azure函数中Aspose.Word加载GIF链接时libSkiaSharp报错求助

• 确认Azure Function架构匹配与加载逻辑
  虽然你部署了多架构的libSkiaSharp.dll，但Azure Function可能未正确加载对应平台的native库：

  • 登录Azure Portal，进入Function应用的配置→常规设置，检查「平台架构」是否与你部署的目标架构一致（比如x64）；
  • 本地调试时的运行架构（比如Visual Studio的解决方案平台设置）要和Azure上的架构保持统一，避免跨架构加载错误。

• 排查SkiaSharp版本传递冲突
  Aspose.Word自身依赖特定版本的SkiaSharp，手动安装的版本可能和Aspose.Word的依赖版本存在隐性冲突：

  • 打开项目的packages.lock.json，搜索SkiaSharp，确认是否存在多个版本的引用；
  • 在csproj文件中强制指定SkiaSharp版本（需在[88.1, 89.0)范围内，比如88.8.0），并配置传递依赖规则：

    <PackageReference Include="SkiaSharp" Version="88.8.0">
      <PrivateAssets>all</PrivateAssets>
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
    </PackageReference>
    

  • 清理NuGet缓存后重新构建部署。

• 验证native库的部署完整性
  部署过程中可能出现runtime目录下的native文件丢失或未正确上传：

  • 通过Kudu工具进入site/wwwroot/bin/runtimes目录，检查对应架构的native文件夹中是否存在libSkiaSharp.dll，并核对文件版本与本地一致；
  • 在项目中选中所有libSkiaSharp.dll文件，设置「复制到输出目录」为始终复制，确保部署时文件被完整上传。

• 强制指定SkiaSharp native库加载路径
  手动设置环境变量引导SkiaSharp加载正确的native库：

  • 在Azure Function的配置→应用设置中添加环境变量SKIASHARP_NATIVE_PATH，值为对应架构的native目录绝对路径（比如D:\home\site\wwwroot\bin\runtimes\win-x64\native）；
  • 重启Function应用后测试。

• 简化场景定位问题根源

  • 创建最小化测试Function，仅保留Aspose.Word加载含GIF的HTML的核心逻辑，排除其他业务代码的干扰；
  • 将GIF改为本地嵌入HTML（而非远程链接），测试是否仍崩溃，判断问题是出在GIF的网络加载还是SkiaSharp的图像处理环节。

• 确认Azure Function的.NET运行时版本
  在Azure Portal的配置→常规设置中，检查「.NET版本」是否明确设置为6.0，避免运行时自动降级或使用其他版本导致的兼容性问题。

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