解决PuppeteerSharp生成PDF颜色问题的最佳实践

news2024/9/28 1:56:55

在现代网络开发中，使用爬虫技术生成PDF文件已成为一种常见需求。然而，开发者经常会遇到一些棘手的问题，其中之一便是使用PuppeteerSharp生成PDF时颜色丢失的问题。本篇文章将概述如何解决这一问题，并提供最佳实践和相关代码示例。

概述

PuppeteerSharp是一个强大的.NET库，它允许开发者使用无头浏览器进行网页操作和生成PDF文件。然而，在某些情况下，生成的PDF文件可能会出现颜色丢失的问题。此问题通常是由于CSS设置不当或PuppeteerSharp的PDF生成选项配置不正确导致的。

细节

解决PuppeteerSharp生成PDF颜色问题的关键在于正确配置PdfOptions和CSS规则。此外，使用爬虫代理IP、设置user-agent和cookie等技术，可以提高爬虫效率和稳定性。以下是具体的步骤和代码示例。

1. 设置PuppeteerSharp的PdfOptions

在生成PDF时，需要确保设置了正确的PdfOptions参数。例如，PrintBackground属性应设置为true，以确保背景颜色能够正确显示。

2. 配置CSS规则

在CSS中，使用@media print规则确保在打印或生成PDF时颜色能正确显示。关键是设置-webkit-print-color-adjust: exact。

3. 使用爬虫代理IP

为了提高爬虫效率和稳定性，可以使用爬虫代理IP技术。以下示例代码使用了亿牛云爬虫代理。

4. 设置User-Agent和Cookie

通过设置适当的User-Agent和Cookie，可以模拟真实用户的行为，避免被反爬虫机制检测到。

代码示例

以下是一个使用PuppeteerSharp生成PDF并解决颜色丢失问题的完整代码示例。该代码还包括使用爬虫代理IP、设置User-Agent和Cookie的部分。

using System;
using System.Threading.Tasks;
using PuppeteerSharp;

class Program
{
    static async Task Main(string[] args)
    {
        // 设置爬虫代理IP信息 亿牛云爬虫代理加强版
        string proxyServer = "http://www.16yun.cn:端口";
        string proxyUsername = "用户名";
        string proxyPassword = "密码";

        // 启动浏览器并配置爬虫代理IP
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync(BrowserFetcher.DefaultRevision);
        var launchOptions = new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                $"--proxy-server={proxyServer}",
                "--no-sandbox",
                "--disable-setuid-sandbox"
            }
        };

        using var browser = await Puppeteer.LaunchAsync(launchOptions);
        using var page = await browser.NewPageAsync();

        // 设置代理身份验证
        await page.AuthenticateAsync(new Credentials
        {
            Username = proxyUsername,
            Password = proxyPassword
        });

        // 设置User-Agent和Cookie
        await page.SetUserAgentAsync("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36");
        await page.SetCookieAsync(new CookieParam
        {
            Name = "cookie_name",
            Value = "cookie_value",
            Domain = "zxcs.info"
        });

        // 导航到目标网页
        await page.GoToAsync("https://zxcs.info");

        // 注入CSS规则，确保颜色在PDF中正确显示
        await page.EvaluateFunctionOnNewDocumentAsync(@"
            () => {
                const style = document.createElement('style');
                style.type = 'text/css';
                style.innerHTML = `
                    @media print {
                        @page {
                            margin: 22mm 15mm 35mm 15mm;
                            background-color: teal !important;
                        }
                        html, body, #content, #header, #footer, .page {
                            background-color: teal !important;
                            -webkit-print-color-adjust: exact !important;
                        }
                    }
                `;
                document.head.appendChild(style);
            }
        ");

        // 生成PDF
        await page.PdfAsync("output.pdf", new PdfOptions
        {
            Format = PaperFormat.A4,
            PrintBackground = true,
            PreferCSSPageSize = true,
        });

        await browser.CloseAsync();
    }
}