使用PdfSharp将IFormFile转XImage报错：无法加载图像

问题根源 #

PdfSharp的XImage.FromStream方法会延迟或多次读取流，如果原始流被提前释放（比如用using包裹），或者流位置没有正确重置，就会导致图像解码失败——即使文件本身格式合规、未损坏。

可行解决方案 #

方案1：保留原始流并确保每次读取都重置位置

避免用using提前释放存储图像的MemoryStream，在XImage.FromStream的委托中手动重置流位置：

// 将IFormFile内容复制到MemoryStream，不使用using（需确保XImage使用完毕后手动释放流）
var imageStream = new MemoryStream();
await file.CopyToAsync(imageStream);

// 创建XImage时，委托返回重置位置后的流
XImage img = XImage.FromStream(() => 
{
    imageStream.Position = 0;
    return imageStream;
});

// 使用完XImage后，记得手动释放流
// img.Dispose();
// imageStream.Dispose();

方案2：将图像转为字节数组，每次创建新流

更安全的方式是先把图像转为字节数组，每次调用委托时创建新的MemoryStream，彻底避免流位置和生命周期问题：

byte[] imageBytes;
// 用using临时流读取文件内容
using (var tempStream = new MemoryStream())
{
    await file.CopyToAsync(tempStream);
    imageBytes = tempStream.ToArray();
}

// 每次委托调用都生成新的MemoryStream，确保从起始位置读取
XImage img = XImage.FromStream(() => new MemoryStream(imageBytes));

关键注意事项 #

• 不要在using块内直接使用流创建XImage：using会在代码块结束后立即释放流，而XImage内部可能延迟读取流，导致后续访问失败。
• 确认PdfSharp版本兼容性：如果是.NET Core/.NET 5+环境，建议使用PdfSharpCore包（而非旧版PdfSharp），旧版对.NET Core的流处理存在兼容性问题。
• 再次验证图像格式：即使后缀名正确，也要确认文件实际编码属于支持的格式（GIF/JPEG/PNG/BMP/TGA），比如有些webp格式文件可能被误标为jpg。

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