使用CefSharp将HTML转PDF返回Null，求助技术排查

我使用CefSharp OffScreen实现HTML页面转PDF功能，但转换操作返回Null，目标PDF文件无法生成。尝试改用异步方法后问题仍未解决，代码实现如下：

using System.Runtime.ConstrainedExecution;
using System.Threading.Tasks;
using CefSharp.OffScreen;
using System.Threading;
using CefSharp;

namespace CefTest
{
    public class Program
    {
        private static ChromiumWebBrowser browser;

        [STAThread]
        public static async Task Main(string[] args)
        {
            await HtmlToPdfHeadless();
        }

        private static async Task HtmlToPdfHeadless()
        {
            const string testUrl = "https://www.google.com/";
            var settings = new CefSettings();
            Cef.Initialize(settings);
            browser = new ChromiumWebBrowser(testUrl);
            string path = "Test.pdf";
            Task printToPdfAsync = PrintToPdfAsync(path);
            await printToPdfAsync;
        }

        public static async Task PrintToPdfAsync(string path)
        {
            await browser.PrintToPdfAsync(path);
            Cef.Shutdown();
        }
    }
}

问题排查与修复方案 #

• 必须等待页面加载完成再执行打印
  原代码中创建浏览器实例后立即调用打印，此时页面大概率还未加载完毕，导致打印操作失败。需通过WaitForInitialLoadAsync()方法等待页面加载完成后再执行打印。

• 调整Cef的生命周期管理
  Cef.Shutdown()不能在打印任务未完成时调用，需确保打印操作完全结束后再关闭Cef。同时要检查Cef初始化是否成功，避免后续操作基于未初始化的环境执行。

• 捕获打印操作的返回结果
  PrintToPdfAsync方法会返回bool值表示打印是否成功，接收该值可以明确判断操作结果，便于排查问题。

修复后的完整代码 #

using System;
using System.Threading.Tasks;
using CefSharp.OffScreen;
using CefSharp;

namespace CefTest
{
    public class Program
    {
        private static ChromiumWebBrowser browser;

        [STAThread]
        public static async Task Main(string[] args)
        {
            await HtmlToPdfHeadless();
        }

        private static async Task HtmlToPdfHeadless()
        {
            const string testUrl = "https://www.google.com/";
            var settings = new CefSettings();
            
            // 初始化Cef并检查结果
            if (!Cef.Initialize(settings))
            {
                Console.WriteLine("Cef初始化失败");
                return;
            }

            browser = new ChromiumWebBrowser(testUrl);
            
            // 等待页面加载完成
            await browser.WaitForInitialLoadAsync();

            string path = "Test.pdf";
            bool isPrintSuccess = await PrintToPdfAsync(path);

            Console.WriteLine(isPrintSuccess ? "PDF生成成功" : "PDF生成失败");

            // 所有操作完成后关闭Cef
            Cef.Shutdown();
        }

        public static async Task<bool> PrintToPdfAsync(string path)
        {
            // 返回打印操作的结果
            return await browser.PrintToPdfAsync(path);
        }
    }
}

额外排查点 #

• 检查目标路径是否具备写入权限，确保程序能在指定位置创建文件
• 确认CefSharp版本与项目.NET版本兼容，建议使用最新稳定版
• 检查项目是否包含完整的CefSharp依赖文件（如libcef.dll等），可通过NuGet重新安装完整包

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