API以服务（含管理员权限）运行时XPS转Bitmap生成空白图问题及.NET Core适配方案咨询

AI 小北

2026-4-29

问题分析与解决方案

先来说说你遇到的空白Bitmap问题——这大概率和服务运行的环境权限有关，而非Xps2Image库本身的问题：

为什么管理员服务会生成空白图？

桌面会话隔离：Windows服务默认运行在会话0，而用户交互在会话1+。Xps2Image（以及底层的GDI+渲染）依赖用户会话的桌面资源（比如字体、显示上下文），管理员服务如果用系统账户运行，可能没有访问这些资源的权限，导致渲染失败生成空白图。
打印机权限与上下文：管理员账户未必拥有目标打印机的完整权限，尤其是网络打印机。另外，服务环境下的打印机默认设置可能和普通用户会话不同，导致打印渲染时无法正确获取页面参数。
GDI+资源加载失败：服务环境可能缺少XPS文件中用到的字体或系统组件，Xps2Image无法正确解析渲染，最终输出空白。

解决空白图的临时方案

调整服务登录账户与权限：
把服务的登录账户从系统账户改成有桌面访问权限的本地管理员账户，同时在服务属性里勾选允许服务与桌面交互（注意：Windows 10/Server 2016+对这个选项有严格限制，仅适用于本地账户）。
验证打印机权限：
确保服务登录账户拥有目标打印机的“打印”权限，可以在打印机属性的“安全”选项卡中添加账户并赋予权限。
添加错误日志：
在你的ConvertXpsToImg方法中捕获异常（包括PrintPage事件中的错误），比如打印时是否抛出了权限异常，Xps2Image转换过程中是否有隐性错误被吞掉。

适用于.NET Core的XPS转Bitmap方案

既然Xps2Image不是.NET Core适配版本，推荐几个原生/稳定的替代方案：

1. 使用WPF的XPS包装类（.NET Core 3.0+支持）

.NET Core 3.0及以后支持引用WPF组件，可以直接用System.Windows.Xps.Packaging来解析XPS并渲染为Bitmap。这个方案最贴近原生XPS处理，兼容性最好：

using System.IO;
using System.IO.Packaging;
using System.Windows;
using System.Windows.Documents;
using System.Windows.Media;
using System.Windows.Media.Imaging;

public static void ConvertXpsToBitmapNetCore(string xpsFile, string outputPath, int dpi = 203)
{
    using var package = Package.Open(xpsFile, FileMode.Open);
    using var xpsDoc = new XpsDocument(package, CompressionOption.NotCompressed);
    
    var docSeq = xpsDoc.GetFixedDocumentSequence();
    foreach (var docRef in docSeq.References)
    {
        var fixedDoc = docRef.GetDocument(true);
        foreach (var pageContent in fixedDoc.Pages)
        {
            var fixedPage = pageContent.GetPageRoot(true);
            
            // 计算渲染尺寸（基于目标DPI）
            var scale = dpi / 96.0; // 96是WPF默认DPI
            var renderWidth = (int)(fixedPage.Width * scale);
            var renderHeight = (int)(fixedPage.Height * scale);
            
            var renderTarget = new RenderTargetBitmap(
                renderWidth, renderHeight,
                dpi, dpi,
                PixelFormats.Pbgra32);
            
            // 渲染页面
            fixedPage.Measure(new Size(double.PositiveInfinity, double.PositiveInfinity));
            fixedPage.Arrange(new Rect(new Point(), fixedPage.DesiredSize));
            renderTarget.Render(fixedPage);
            
            // 保存为PNG
            var encoder = new PngBitmapEncoder();
            encoder.Frames.Add(BitmapFrame.Create(renderTarget));
            using var fs = new FileStream(outputPath, FileMode.Create);
            encoder.Save(fs);
        }
    }
}

注意：需要在项目文件中添加WPF依赖，比如：
<ItemGroup>
  <FrameworkReference Include="Microsoft.WindowsDesktop.App.WPF" />
</ItemGroup>

2. 间接转换：XPS → PDF → Bitmap

如果你的场景需要跨平台（Linux/macOS），可以先把XPS转成PDF，再用PdfSharpCore等库转成Bitmap：

用XpsToPdf（.NET Core适配）把XPS转PDF；
用PdfSharpCore加载PDF并渲染为Bitmap。

这个方案的优势是跨平台，缺点是多了一次转换，可能有轻微的画质损失。

3. 使用SkiaSharp（跨平台）

SkiaSharp是Google的跨平台图形库，支持解析XPS（需要注意部分复杂XPS元素的兼容性），可以直接渲染为Bitmap。不过它对XPS的支持不如WPF原生完善，适合简单的XPS文件转换。

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