C#でHTMLをPDFに - ライブラリオプションの現実

wkhtmltopdfラッパー - DLL読み込みエラーエコシステム

開発者がこれらの記事にたどり着く最も一般的な検索クエリは、以下のようなバリエーションです：

System.DllNotFoundException：DLL 'libwkhtmltox' をロードできません。

プラットフォーム固有のバリエーションは以下のとおりです：

共有ライブラリ 'wkhtmltox'またはその依存関係の1つをロードできません。
    (Linux — libwkhtmltox.so not found)

指定されたモジュールが見つかりません。 (0x8007007E)
    (Windows — wkhtmltox.dll path not configured)

dyld：ライブラリがロードされていません: libwkhtmltox.dylib
    (macOS — not supported on ARM64/Apple Silicon)

これらのエラーは、DinkToPdf、NReco.PdfGenerator、WkHtmlToXSharp、および同じ放棄されたバイナリの周りの他のC#ラッパーから来ています。 wkhtmltopdf GitHub 組織は、2024 年 7 月にアーカイブされました。 基礎となる QtWebKit エンジンは、2015 年に Qt によって廃止されました。プロジェクトのステータスページでは、非推奨と明示されています。

DLLの読み込みの問題以外にも、レンダリングエンジンはSafari 2011の機能程度で止まっています。 Flexboxなし、Gridなし、限られたCSS3、信頼できないJavaScript。 また、パッチが適用されていない重大な脆弱性があります：CVE-2022-35583(CVSS 9.8)は、細工されたHTMLを通してAWSの認証情報を流出させるSSRF攻撃を可能にします。

wkhtmltopdfの時間は過ぎました。 DLLの読み込みエラーは、より深い問題の徴候です：あなたは、先の見えない見捨てられたソフトウェアに依存しています。

iText 7 (pdfHTML アドオン) - 限定 CSS、AGPL ライセンス

なぜPdfSharpはHTMLをサポートしないのですか?

PdfSharpは、その人気（NuGetダウンロード数3,490万）と頻繁な推奨により、"HTML to PDF"の検索結果に表示されます。 しかし、PdfSharpにはHTMLパーサーがありません。 座標ベースの描画APIを提供します：DrawString()、DrawRectangle()、DrawImage()で、X/Y 位置を明示的に指定できます。

一般的に提案されている回避策、HtmlRenderer.PdfSharpは、HTML 4.01とCSS Level 2のみをサポートしています。 HTMLに2010年以降に導入されたCSS機能（Flexbox（2012年）、Grid（2017年）、カスタムプロパティ（2017年）、border-radius（2011年））が使用されている場合、レンダリングされません。

HTMLのサポートを期待してPdfSharpを選択した開発者は、座標ベースのコードですべての要素を手動で配置するか、HTMLレンダリングのために2つ目のライブラリを追加することになります。

何がPuppeteer Sharpをリソース集約型にしているのですか？

Puppeteer Sharp は、.NETバインディングを介してヘッドレスChromeを制御します。 Chromeであるため、レンダリング精度はChromeに合わせます。 外部ブラウザのプロセスを管理します。

チュートリアルの5行の例ではなく、同時PDF生成に必要なブラウザプーリングのコードです：

using PuppeteerSharp;
using System.Collections.Concurrent;

public class PdfBrowserPool : IAsyncDisposable
{
    private readonly ConcurrentBag<IBrowser> _available = new();
    private readonly SemaphoreSlim _semaphore;
    private readonly int _maxBrowsers;

    public PdfBrowserPool(int maxBrowsers = 4)
    {
        _maxBrowsers = maxBrowsers;
        _semaphore = new SemaphoreSlim(maxBrowsers, maxBrowsers);
    }

    public async Task InitializeAsync()
    {
        await new BrowserFetcher().DownloadAsync(); // ~280MB download
        for (int i = 0; i < _maxBrowsers; i++)
        {
            var browser = await Puppeteer.LaunchAsync(new LaunchOptions
            {
                Headless = true,
                Args = new[] { "--no-sandbox", "--disable-setuid-sandbox",
                               "--disable-dev-shm-usage" }
            });
            _available.Add(browser);
        }
    }

    public async Task<byte[]> ConvertHtmlToPdf(string html)
    {
        await _semaphore.WaitAsync();
        IBrowser browser = null;
        try
        {
            if (!_available.TryTake(out browser))
                throw new InvalidOperationException("No browser available");

            await using var page = await browser.NewPageAsync();
            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 }
            });
            var result = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true
            });
            return result;
        }
        catch (Exception ex) when (ex is NavigationException or TargetClosedException)
        {
            // Browser crashed — replace it
            browser?.Dispose();
            browser = await Puppeteer.LaunchAsync(new LaunchOptions
            {
                Headless = true,
                Args = new[] { "--no-sandbox", "--disable-setuid-sandbox" }
            });
            throw; // Re-throw after recovery
        }
        finally
        {
            if (browser != null) _available.Add(browser);
            _semaphore.Release();
        }
    }

    public async ValueTask DisposeAsync()
    {
        foreach (var browser in _available)
        {
            await browser.CloseAsync();
            browser.Dispose();
        }
    }
}

using PuppeteerSharp;
using System.Collections.Concurrent;

public class PdfBrowserPool : IAsyncDisposable
{
    private readonly ConcurrentBag<IBrowser> _available = new();
    private readonly SemaphoreSlim _semaphore;
    private readonly int _maxBrowsers;

    public PdfBrowserPool(int maxBrowsers = 4)
    {
        _maxBrowsers = maxBrowsers;
        _semaphore = new SemaphoreSlim(maxBrowsers, maxBrowsers);
    }

    public async Task InitializeAsync()
    {
        await new BrowserFetcher().DownloadAsync(); // ~280MB download
        for (int i = 0; i < _maxBrowsers; i++)
        {
            var browser = await Puppeteer.LaunchAsync(new LaunchOptions
            {
                Headless = true,
                Args = new[] { "--no-sandbox", "--disable-setuid-sandbox",
                               "--disable-dev-shm-usage" }
            });
            _available.Add(browser);
        }
    }

    public async Task<byte[]> ConvertHtmlToPdf(string html)
    {
        await _semaphore.WaitAsync();
        IBrowser browser = null;
        try
        {
            if (!_available.TryTake(out browser))
                throw new InvalidOperationException("No browser available");

            await using var page = await browser.NewPageAsync();
            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 }
            });
            var result = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true
            });
            return result;
        }
        catch (Exception ex) when (ex is NavigationException or TargetClosedException)
        {
            // Browser crashed — replace it
            browser?.Dispose();
            browser = await Puppeteer.LaunchAsync(new LaunchOptions
            {
                Headless = true,
                Args = new[] { "--no-sandbox", "--disable-setuid-sandbox" }
            });
            throw; // Re-throw after recovery
        }
        finally
        {
            if (browser != null) _available.Add(browser);
            _semaphore.Release();
        }
    }

    public async ValueTask DisposeAsync()
    {
        foreach (var browser in _available)
        {
            await browser.CloseAsync();
            browser.Dispose();
        }
    }
}

Imports PuppeteerSharp
Imports System.Collections.Concurrent
Imports System.Threading

Public Class PdfBrowserPool
    Implements IAsyncDisposable

    Private ReadOnly _available As New ConcurrentBag(Of IBrowser)()
    Private ReadOnly _semaphore As SemaphoreSlim
    Private ReadOnly _maxBrowsers As Integer

    Public Sub New(Optional maxBrowsers As Integer = 4)
        _maxBrowsers = maxBrowsers
        _semaphore = New SemaphoreSlim(maxBrowsers, maxBrowsers)
    End Sub

    Public Async Function InitializeAsync() As Task
        Await (New BrowserFetcher()).DownloadAsync() ' ~280MB download
        For i As Integer = 0 To _maxBrowsers - 1
            Dim browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {
                .Headless = True,
                .Args = New String() {"--no-sandbox", "--disable-setuid-sandbox", "--disable-dev-shm-usage"}
            })
            _available.Add(browser)
        Next
    End Function

    Public Async Function ConvertHtmlToPdf(html As String) As Task(Of Byte())
        Await _semaphore.WaitAsync()
        Dim browser As IBrowser = Nothing
        Try
            If Not _available.TryTake(browser) Then
                Throw New InvalidOperationException("No browser available")
            End If

            Await Using page = Await browser.NewPageAsync()
                Await page.SetContentAsync(html, New NavigationOptions With {
                    .WaitUntil = New WaitUntilNavigation() {WaitUntilNavigation.Networkidle0}
                })
                Dim result = Await page.PdfAsync(New PdfOptions With {
                    .Format = PaperFormat.A4,
                    .PrintBackground = True
                })
                Return result
            End Using
        Catch ex As Exception When TypeOf ex Is NavigationException OrElse TypeOf ex Is TargetClosedException
            ' Browser crashed — replace it
            browser?.Dispose()
            browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {
                .Headless = True,
                .Args = New String() {"--no-sandbox", "--disable-setuid-sandbox"}
            })
            Throw ' Re-throw after recovery
        Finally
            If browser IsNot Nothing Then _available.Add(browser)
            _semaphore.Release()
        End Try
    End Function

    Public Async Function DisposeAsync() As ValueTask Implements IAsyncDisposable.DisposeAsync
        For Each browser In _available
            Await browser.CloseAsync()
            browser.Dispose()
        Next
    End Function
End Class

これは、1つのPDFを生成する前に、インフラストラクチャコードの〜60行です。 また、メモリリーク監視（Chromiumプロセスは時間とともにメモリを蓄積します）、ヘルスチェック、20以上のChromium依存関係を含むDockerfileも必要です。 Dockerイメージのサイズは300-400MB増加します。

IronPDFのアプローチと比較してください：

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
// Browser pooling, process management, crash recovery — handled internally

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
// Browser pooling, process management, crash recovery — handled internally

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(html)
' Browser pooling, process management, crash recovery — handled internally

Puppeteer Sharpは、チームが運用のオーバーヘッドを吸収できるのであれば、実行可能です。 ブラウザのインフラよりもアプリケーションに集中したいチームのために、IronPdfは同じレンダリングを内部で処理します。

なぜQuestPDFはHTMLを変換できないのですか？

QuestPDFは、RedditやStack Overflowのほぼすべての"HTML to PDF C#"ディスカッションに登場します。 このため、開発者はQuestPDFを購入したり、HTML変換を期待して組み込んだのに、HTMLがまったくレンダリングされないという一貫したパターンが発生します。

QuestPDF は、プログラムによる文書作成のための流暢な C# API です。 HTMLからPDFへの変換と格闘するのはもうやめよう"というのが、このツールの位置づけです。 これは意図的な設計上の選択です。2022年から2024年までのGitHubの議論では、実装を開始した後に開発者がこのことを発見しています。 メンテナンス担当者は、HTMLのサポートが予定されていないことを一貫して確認しています。

既存のワークフローでHTMLテンプレート（請求書用のRazorビュー、レポート用のダッシュボードHTML、アーカイブ用のWebコンテンツ）を使用している場合、QuestPDFではすべてのテンプレートをC#流暢なAPIコードで書き直す必要があります。 構造化データを使ってゼロからドキュメントレイアウトを構築する新しいプロジェクトにとって、QuestPDFのAPIはよく設計されており、生産的です。

コミュニティライセンスは、年間総収入100万ドル未満の企業を対象としています。 その上で、商用ライセンスが必要です。

Aspose.PDFについて

Aspose.PDFは、商用ライセンス（～999ドル/開発者）で幅広いPDF機能を提供します。 HTMLの変換には、ブラウザではなくカスタムエンジンを使用します。iTextと同様、基本的なHTMLは処理できますが、最新のCSS機能を正確にレンダリングすることはできません。

最大の関心事はプラットフォームの安定性です：AsposeはSystem.Drawing.Commonに依存しており、Linuxではlibgdiplusが必要です。 マイクロソフトは、.NET 6+で、Windows以外のプラットフォーム向けの翻訳を非推奨としました。 開発者は、Windows では発生しない Linux デプロイメント特有のメモリリークを報告しています。 Windowsのみの環境では、Asposeが可能です。 クロスプラットフォームやコンテナ化されたデプロイメントでは、依存関係の連鎖が継続的なリスクを生み出します。

他のライブラリからどのように移行できますか?

iTextSharpやwkhtmltopdfから移行するチームにとって、IronPDFはURLを直接受け取ることができます：

using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert from URL — useful when migrating from wkhtmltopdf URL-based workflows
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/reports/quarterly");
pdf.SaveAs("report.pdf");

// Convert from local HTML file
var pdfFromFile = renderer.RenderHtmlFileAsPdf("templates/invoice.html");
pdfFromFile.SaveAs("invoice.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert from URL — useful when migrating from wkhtmltopdf URL-based workflows
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/reports/quarterly");
pdf.SaveAs("report.pdf");

// Convert from local HTML file
var pdfFromFile = renderer.RenderHtmlFileAsPdf("templates/invoice.html");
pdfFromFile.SaveAs("invoice.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Convert from URL — useful when migrating from wkhtmltopdf URL-based workflows
Dim pdf = renderer.RenderUrlAsPdf("https://localhost:5001/reports/quarterly")
pdf.SaveAs("report.pdf")

' Convert from local HTML file
Dim pdfFromFile = renderer.RenderHtmlFileAsPdf("templates/invoice.html")
pdfFromFile.SaveAs("invoice.pdf")

展開

IronPdfはWindows (x64)、Linux (x64、ARM64)、macOS (x64、Apple Silicon)、Dockerコンテナ上で動作します。 Docker構成は標準的な.NETイメージです：

FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app
COPY . .
ENTRYPOINT ["dotnet", "MyApp.dll"]

Chromiumのインストール、ネイティブ・ライブラリの依存、サンドボックスの設定は不要です。

ライセンス: 749ドルからの永続ライセンス。価格はironPdf.comで公開されています。 AGPL、文書ごとの料金、収益のしきい値はありません。