迁移至ImageSharp后抛出System.MissingMethodException的排查与解决

问题背景 #

原本使用System.Drawing库创建图像（仅Windows兼容），迁移至ImageSharp库以支持Linux，代码片段如下：

Stream imageStream= GetImage(imageUrl);

Image image= Image.Load(imageStream);
image.Mutate(img=>img.Resize(width,height));
MemoryStream ms = new MemoryStream();
image.SaveAsPng(ms);
return XImage.FromStream(()=>new MemoryStream(ms.ToArray())); 

报错信息 #

System.MissingMethodException: Method not found: 'SixLabors.ImageSharp.Image`1<!!0> SixLabors.ImageSharp.Image.Load(System.IO.Stream, SixLabors.ImageSharp.Formats.IImageFormat ByRef)'

环境版本 #

• Pdfsharpcore 1.3.63
• Imagesharp 3.14
• .Net 6.0

原因分析 #

该错误本质是版本兼容性冲突：PdfSharpCore 1.3.63依赖的ImageSharp版本与你使用的3.14版本不匹配。PdfSharpCore内部调用的Image.Load(Stream, out IImageFormat)方法签名，在ImageSharp 3.x版本中已被修改（移除或重构了out参数重载），导致运行时找不到对应方法。

解决方案 #

方案一：降级ImageSharp至兼容版本 #

PdfSharpCore 1.3.63官方兼容ImageSharp 2.x系列（推荐2.1.3版本），通过NuGet安装指定版本：

Install-Package SixLabors.ImageSharp -Version 2.1.3

或直接在项目文件.csproj中指定版本：

<PackageReference Include="SixLabors.ImageSharp" Version="2.1.3" />

方案二：修改代码避免方法签名冲突 #

显式指定ImageSharp图像类型，确保流处理逻辑不依赖PdfSharpCore与ImageSharp的冲突重载：

Stream imageStream = GetImage(imageUrl);

// 显式使用泛型Image<Rgba32>，避免隐式调用旧版本重载
using var image = Image.Load<Rgba32>(imageStream);
image.Mutate(img => img.Resize(width, height));

using var ms = new MemoryStream();
image.SaveAsPng(ms);
ms.Position = 0; // 重置流读取位置

// 传递独立的流副本，确保XImage可正常读取
return XImage.FromStream(() => new MemoryStream(ms.ToArray()));

注意：使用using关键字包裹所有实现IDisposable的对象（如Image、MemoryStream），避免资源泄漏。

额外检查 #

• 清理项目NuGet缓存，确保没有多版本ImageSharp共存
• 检查项目依赖树，确认所有引用ImageSharp的包版本一致

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