.NET 免費 PDF 庫：隱藏成本及 C# 中的更佳替代方案

在.NET PDF 庫中，"免費"究竟意味著什麼？

在NuGet上搜尋"PDF"，你會發現涵蓋五種授權模式的函式庫，每種模式對.NET部署有不同的限制：

MIT/Apache(真正寬鬆)： PdfSharp。可用於商業應用程式、Docker 容器、Azure Functions、AWS Lambda——無限制、無收入門檻、無需公開原始碼。 缺點是：它無法將 HTML 轉換為 PDF。

AGPL(版權自由陷阱)： iText Core(原名 iTextSharp)。 將其部署到任何可透過網路存取的應用程式(Web 應用程式、REST API、微服務)中，並且您必須根據 AGPL 發布您的全部原始程式碼。 SaaS公司也不例外。

付費授權： QuestPDF 社群版授權。 年營業額低於 100 萬美元的企業免收費。 超過這個門檻，你就需要商業許可證了。 這種轉變不是漸進的，而是斷崖式的。

已棄用： wkhtmltopdf 和所有.NET封裝器。 已存檔，包含未修復的 CVE 漏洞，嚴重程度為 9.8。 無需任何安全維護。 在任何合規性審計中都是一項風險。

營運成本高： PuppeteerSharp 和 Playwright for .NET。 沒有許可限制，完全支援現代 CSS——但您需要在生產環境中管理外部瀏覽器進程、Chromium 下載和記憶體生命週期。

每個類別都會為.NET部署帶來不同的風險。 本文的其餘部分將透過程式碼、數字和NuGet生態系統資料來分析這些風險。

為什麼iText的定價才是真正的關鍵？

大多數關於 iText 的文章都集中在 AGPL 的執行角度。 這部分內容在其他地方已經被介紹過了。 對於評估 PDF 庫的.NET團隊來說，更相關的問題是，當需要商業許可證時會發生什麼。

PdfSharp 在.NET部署方面有哪些限制？

PdfSharp是免費庫中的例外：MIT 許可證， NuGet下載量超過 3,400 萬次，真正允許商業用途。 沒有收入門檻。 不公開原始碼。

限制因素是架構上的。 PdfSharp 在 PDF 座標層級進行操作。 沒有HTML解析器，沒有CSS引擎，也沒有DOM渲染。

var document = new PdfDocument();
var page = document.AddPage();
var gfx = XGraphics.FromPdfPage(page);

// Every element needs manual coordinates
var titleFont = new XFont("Arial", 18, XFontStyleEx.Bold);
var bodyFont = new XFont("Arial", 10);

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72);
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100);

// Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140);
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155);
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155);
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155);
gfx.DrawLine(XPens.Black, 72, 170, 540, 170);

// Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185);
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185);
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185);

document.Save("invoice.pdf");

var document = new PdfDocument();
var page = document.AddPage();
var gfx = XGraphics.FromPdfPage(page);

// Every element needs manual coordinates
var titleFont = new XFont("Arial", 18, XFontStyleEx.Bold);
var bodyFont = new XFont("Arial", 10);

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72);
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100);

// Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140);
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155);
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155);
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155);
gfx.DrawLine(XPens.Black, 72, 170, 540, 170);

// Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185);
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185);
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185);

document.Save("invoice.pdf");

那可是 20 行文字，卻只有一行，沒有任何樣式、響應式版面或 CSS。 現在想像一下，要製作一份包含動態數據、圖表和企業品牌資訊的 15 頁合規報告。

QuestPDF何時停止免費？

QuestPDF 採用了與 PdfSharp 不同的設計方法：它使用流暢的 API，其內容更像是佈局描述，而不是坐標數學運算。 API設計確實不錯。

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);

        page.Content().Column(column =>
        {
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold();
            column.Item().Table(table =>
            {
                table.ColumnsDefinition(columns =>
                {
                    columns.RelativeColumn(3);
                    columns.RelativeColumn(1);
                    columns.RelativeColumn(1);
                });

                table.Cell().Text("Item").Bold();
                table.Cell().Text("Qty").Bold();
                table.Cell().Text("Price").Bold();

                table.Cell().Text("Annual License");
                table.Cell().Text("1");
                table.Cell().Text("$749.00");
            });
        });
    });
}).GeneratePdf("invoice.pdf");

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);

        page.Content().Column(column =>
        {
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold();
            column.Item().Table(table =>
            {
                table.ColumnsDefinition(columns =>
                {
                    columns.RelativeColumn(3);
                    columns.RelativeColumn(1);
                    columns.RelativeColumn(1);
                });

                table.Cell().Text("Item").Bold();
                table.Cell().Text("Qty").Bold();
                table.Cell().Text("Price").Bold();

                table.Cell().Text("Annual License");
                table.Cell().Text("1");
                table.Cell().Text("$749.00");
            });
        });
    });
}).GeneratePdf("invoice.pdf");

這比 PdfSharp 的座標系更具表現力。 但它也存在著同樣的根本限制：無法渲染 HTML。

為什麼在任何.NET部署中都應該避免使用 wkhtmltopdf？

我之所以以 CVE-2022-35583 作為本文的開頭是有原因的。 該 SSRF 漏洞並非理論上的——概念驗證漏洞利用程序已公開可用並積極使用。

PuppeteerSharp 的真實營運成本是多少？

這是大多數"免費PDF庫"文章都會犯的錯誤部分。 PuppeteerSharp 和 Playwright for .NET在技術上非常出色——它們透過真正的 Chromium 渲染 HTML，支援所有 CSS 功能和JavaScript API。 無許可限制。 沒有收入門檻。

成本是營運成本。 以下是 PuppeteerSharp 實際產生的 PDF 檔案的樣子：

using PuppeteerSharp;

public class PuppeteerPdfService : IDisposable
{
    private IBrowser _browser;
    private readonly SemaphoreSlim _semaphore;
    private long _pdfCount = 0;

    public PuppeteerPdfService()
    {
        // Limit concurrent pages to prevent memory exhaustion
        _semaphore = new SemaphoreSlim(3, 3);
    }

    public async Task InitializeAsync()
    {
        // Step 1: Download Chromium binary (~280MB)
        var fetcher = new BrowserFetcher();
        await fetcher.DownloadAsync();

        // Step 2: Launch with production-hardened flags
        _browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                "--no-sandbox",              // Required in Docker
                "--disable-setuid-sandbox",  // Required in Docker
                "--disable-dev-shm-usage",   // Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            Timeout = 30000
        });
    }

    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        await _semaphore.WaitAsync();
        IPage page = null;

        try
        {
            Interlocked.Increment(ref _pdfCount);
            page = await _browser.NewPageAsync();

            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 },
                Timeout = 20000
            });

            var pdfBytes = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true,
                MarginOptions = new MarginOptions
                {
                    Top = "20mm", Bottom = "20mm",
                    Left = "15mm", Right = "15mm"
                }
            });

            return pdfBytes;
        }
        finally
        {
            if (page != null)
            {
                try { await page.CloseAsync(); }
                catch { /* Disposal can hang — GitHub issue #1489 */ }
            }
            _semaphore.Release();
        }
    }

    // Restart browser periodically to reclaim leaked memory
    public async Task RecycleBrowserAsync()
    {
        var oldBrowser = _browser;
        await InitializeAsync();
        try { oldBrowser?.Dispose(); } catch { }
    }

    public void Dispose()
    {
        _browser?.Dispose();
        _semaphore?.Dispose();
    }
}

using PuppeteerSharp;

public class PuppeteerPdfService : IDisposable
{
    private IBrowser _browser;
    private readonly SemaphoreSlim _semaphore;
    private long _pdfCount = 0;

    public PuppeteerPdfService()
    {
        // Limit concurrent pages to prevent memory exhaustion
        _semaphore = new SemaphoreSlim(3, 3);
    }

    public async Task InitializeAsync()
    {
        // Step 1: Download Chromium binary (~280MB)
        var fetcher = new BrowserFetcher();
        await fetcher.DownloadAsync();

        // Step 2: Launch with production-hardened flags
        _browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                "--no-sandbox",              // Required in Docker
                "--disable-setuid-sandbox",  // Required in Docker
                "--disable-dev-shm-usage",   // Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            Timeout = 30000
        });
    }

    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        await _semaphore.WaitAsync();
        IPage page = null;

        try
        {
            Interlocked.Increment(ref _pdfCount);
            page = await _browser.NewPageAsync();

            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 },
                Timeout = 20000
            });

            var pdfBytes = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true,
                MarginOptions = new MarginOptions
                {
                    Top = "20mm", Bottom = "20mm",
                    Left = "15mm", Right = "15mm"
                }
            });

            return pdfBytes;
        }
        finally
        {
            if (page != null)
            {
                try { await page.CloseAsync(); }
                catch { /* Disposal can hang — GitHub issue #1489 */ }
            }
            _semaphore.Release();
        }
    }

    // Restart browser periodically to reclaim leaked memory
    public async Task RecycleBrowserAsync()
    {
        var oldBrowser = _browser;
        await InitializeAsync();
        try { oldBrowser?.Dispose(); } catch { }
    }

    public void Dispose()
    {
        _browser?.Dispose();
        _semaphore?.Dispose();
    }
}

也就是說，在產生第一個 PDF 檔案之前，已經運行了 80 多行程式碼。 而且它仍然缺少生產系統所需的錯誤恢復、健康檢查、指標和記憶體回收計時器。

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

.NET生態系健康狀況： NuGet套件比較

在選擇庫之前，請檢查其NuGet生態系統的健康狀況。 依賴關係鏈、發布頻率和問題解決時間比功能清單更能說明問題：

像 DinkToPdf 這樣已被棄用的軟體包的高下載量反映的是舊版軟體的使用情況，而不是當前的軟體健康狀況。 300 多個未解決的問題都沒有得到回應，這才是問題的真相。

對於面向 net8.0 TFM 的.NET 8 應用程式：PdfSharp、QuestPDF、iText Core 和IronPDF都原生支援它。 wkhtmltopdf 包裝器不會出現 DllNotFoundException 和 NU1202 目標框架不相容錯誤。

決策矩陣

如果您只需要從結構化資料中以程式設計方式建立 PDF： PdfSharp（MIT，無限制）或 QuestPDF（更好的 API，注意收入門檻）。

如果您需要使用現代 CSS 將 HTML 轉換為 PDF，並且不想管理瀏覽器基礎架構： IronPDF 。 嵌入式 Chromium 負責處理渲染引擎的生命週期。 公開定價僅為 iText 訂閱模式的一小部分。

如果您需要將 HTML 轉換為 PDF，並且熟悉瀏覽器進程的管理： PuppeteerSharp 為您提供完全的控制權。 編制營運費用預算。

如果您目前正在使用 wkhtmltopdf 或其任何包裝器：請遷移。 光是安全隱憂就足以證明這項工作的必要性——而且你每拖延一個月，CVE 清單上的漏洞就無法修復。