为何首次调用PuppeteerSharp生成PDF的GoToAsync比后续调用慢？

首次调用page.GoToAsync耗时远高于后续调用，核心原因有两点：

1. Chrome实例冷启动的资源初始化开销：每次请求都通过Puppeteer.LaunchAsync新建Chrome实例，首次启动时需要加载Chrome二进制文件、初始化V8引擎、渲染引擎等核心组件，同时首次解析heavy.html中的复杂JS/CSS时，V8需要进行JIT编译预热，这些操作都会大幅增加页面加载耗时。后续请求时，操作系统会将Chrome相关资源缓存到内存，新实例启动和页面解析的开销被显著降低。
2. 本地资源的缓存未建立：首次请求heavy.html时，无论是通过HTTP请求还是本地文件读取，都需要从磁盘加载内容并解析；后续请求时，文件系统或HTTP缓存会直接返回内存中的缓存内容，减少了IO和解析开销。

1. 复用Chrome浏览器实例（最核心优化） #

当前代码每次请求都创建并销毁Chrome实例，这是最大的性能浪费。将浏览器实例注册为单例，在应用启动时初始化，后续请求复用该实例仅创建新页面，能彻底解决冷启动问题。

实现步骤： #

• 在Program.cs中注册单例浏览器：

builder.Services.AddSingleton(async provider =>
{
    var launchOptions = new LaunchOptions
    {
        ExecutablePath = @"C:\ChromeHeadless\chrome-headless-shell.exe",
        Headless = true,
        Args = new[]
        {
            "--no-sandbox", // 非生产环境可关闭沙箱减少开销
            "--disable-gpu", // 无头模式无需GPU加速
            "--disable-extensions",
            "--disable-dev-shm-usage"
        }
    };
    return await Puppeteer.LaunchAsync(launchOptions);
});

// 注册生命周期管理服务，确保应用关闭时销毁浏览器
builder.Services.AddHostedService<BrowserLifetimeService>();

• 实现生命周期管理服务BrowserLifetimeService：

public class BrowserLifetimeService : IHostedService
{
    private readonly IBrowser _browser;

    public BrowserLifetimeService(IBrowser browser)
    {
        _browser = browser;
    }

    public Task StartAsync(CancellationToken cancellationToken) => Task.CompletedTask;

    public async Task StopAsync(CancellationToken cancellationToken)
    {
        await _browser.CloseAsync();
    }
}

• 修改控制器注入浏览器实例，移除每次启动浏览器的逻辑：

private readonly ILogger<PdfController> _logger;
private readonly IBrowser _browser;

public PdfController(ILogger<PdfController> logger, IBrowser browser)
{
    _logger = logger;
    _browser = browser;
}

[HttpGet("pdf")]
public async Task<IActionResult> Get()
{
    Stream pdfStream;
    Stopwatch stopwatch2 = new Stopwatch();
    Stopwatch stopwatch3 = new Stopwatch();
    Stopwatch stopwatch4 = new Stopwatch();

    stopwatch2.Start();
    using (var page = await _browser.NewPageAsync())
    {
        stopwatch2.Stop();
        stopwatch3.Start();
        await page.GoToAsync("https://localhost/heavy.html");
        stopwatch3.Stop();
        stopwatch4.Start();
        pdfStream = await page.PdfStreamAsync(
            new PdfOptions
            {
                PreferCSSPageSize = true,
                PrintBackground = true
            }
        );
        stopwatch4.Stop();
    }

    _logger.LogInformation("browser.NewPageAsync: {elapsed}", stopwatch2.ElapsedMilliseconds);
    _logger.LogInformation("page.GoToAsync: {elapsed}", stopwatch3.ElapsedMilliseconds);
    _logger.LogInformation("page.PdfStreamAsync: {elapsed}", stopwatch4.ElapsedMilliseconds);

    ContentDispositionHeaderValue contentDisposition = new ContentDispositionHeaderValue("inline");
    contentDisposition.SetHttpFileName($"Browser Test.pdf");
    Response.Headers[HeaderNames.ContentDisposition] = contentDisposition.ToString();
    return File(pdfStream, "application/pdf");
}

2. 跳过HTTP请求，直接加载本地HTML内容 #

如果heavy.html是本地文件，直接读取文件内容并通过page.SetContentAsync加载，避免HTTP请求的开销：

// 替换page.GoToAsync逻辑
var htmlPath = @"path/to/heavy.html";
var htmlContent = await File.ReadAllTextAsync(htmlPath);
await page.SetContentAsync(htmlContent);

3. 预热页面，提前完成JIT编译 #

在应用启动时，提前加载一次heavy.html，触发V8的JIT编译和资源缓存，后续用户请求时页面加载耗时会显著降低：

// 修改BrowserLifetimeService的StartAsync方法
public async Task StartAsync(CancellationToken cancellationToken)
{
    using var page = await _browser.NewPageAsync();
    await page.GoToAsync("https://localhost/heavy.html");
    // 或使用SetContentAsync加载本地内容
}

4. 调整页面加载等待策略 #

如果heavy.html的核心内容在DOM加载完成后就已就绪，可以修改GoToAsync的等待时机，减少不必要的等待：

await page.GoToAsync("https://localhost/heavy.html", new NavigationOptions
{
    WaitUntil = new[] { WaitUntilNavigation.DOMContentLoaded }
});

5. 优化Chrome启动参数 #

添加以下参数可以进一步降低Chrome启动和运行的开销：

• --single-process: 单进程模式（减少进程创建开销，稳定性略有下降）
• --disable-background-networking: 禁用后台网络请求
• --disable-default-apps: 禁用默认应用

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