.NET 8 문서 생성 라이브러리 선택

iTextSharp — .NET 8과 호환되지 않음

iText의 원래 .NET 포트인 iTextSharp은 2018년 이후로 업데이트되지 않았습니다. .NET Framework에만 타겟됩니다:

error NU1202: 패키지 iTextSharp 5.5.13은 net8.0과 호환되지 않습니다.

마이그레이션 경로는 iText 7이며, 이는 다른 API를 가지며 AGPL 준수(전체 애플리케이션을 오픈 소스로 공개) 또는 상용 라이선스를 요구합니다. 가격은 공개되지 않았으며, 제3자 데이터에 따르면 연간 $15,000–$210,000입니다.

wkhtmltopdf 래퍼 — .NET 8에서 DLL 로딩 실패

wkhtmltopdf(DinkToPdf, Rotativa, NReco.PdfGenerator) 주위의 C# 래퍼는 .NET 8의 배포 모델에 특유한 플랫폼별 오류와 함께 실패합니다:

DinkToPdf — 기본 라이브러리를 찾을 수 없습니다:

System.DllNotFoundException: DLL 'libwkhtmltox'를 로드할 수 없음

Rotativa.AspNetCore — .NET 8의 컨테이너 우선 배포와 충돌하는 수동 이진 경로 설정 필요:

// This pattern requires deploying wkhtmltopdf binaries alongside your app
// and breaks in Docker containers without explicit path configuration
RotativaConfiguration.Setup(env.WebRootPath, "wkhtmltopdf");

// This pattern requires deploying wkhtmltopdf binaries alongside your app
// and breaks in Docker containers without explicit path configuration
RotativaConfiguration.Setup(env.WebRootPath, "wkhtmltopdf");

TuesPechkin / NReco — 아키텍처 불일치:

System.BadImageFormatException: 파일 또는 어셈블리를 로드할 수 없습니다

이 오류는 더 깊은 문제를 반영합니다: wkhtmltopdf는 2024년 7월에 보안 취약점(CVE)이 수정되지 않은 채 아카이브되었습니다. 해당 기본 바이너리 아키텍처는 .NET 8의 플랫폼 감지 개선 전에 존재했습니다. 수정 방법은 없으며, 다른 라이브러리로의 마이그레이션만 가능합니다.

PdfSharp— 리눅스에서 System.Drawing.Common 실패

PdfSharp는 System.Drawing.Common에 의존하며, 마이크로소프트는 .NET 6에서 비-윈도우 플랫폼용으로 자주적되지 않았습니다. .NET 8에서는 리눅스 또는 Docker로 배포 시 런타임 실패가 발생합니다:

using PdfSharp.Pdf;
using PdfSharp.Drawing;

var document = new PdfDocument();
// PlatformNotSupportedException on Linux:
// System.Drawing.Common is not supported on this platform

using PdfSharp.Pdf;
using PdfSharp.Drawing;

var document = new PdfDocument();
// PlatformNotSupportedException on Linux:
// System.Drawing.Common is not supported on this platform

PdfSharp 6.x는 이 의존성을 제거하기 위해 노력 중이지만, 2026년 초까지 크로스 플랫폼 지원이 불완전합니다. 윈도우 전용 배포의 경우, PdfSharp는 .NET 8과 잘 작동합니다. 리눅스, Docker, 클라우드 배포의 경우, 신뢰할 수 없습니다.

IronPDF— 전체 .NET 8 지원, 크로스 플랫폼

IronPDF는 내장된 Chromium 렌더링으로 net8.0를 본래적으로 타겟합니다. System.Drawing.Common 의존성 없음, 네이티브 바이너리 관리 없음, 플랫폼별 설정 없음.

최소 API 통합 (기본 .NET 8 패턴):

using IronPdf;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/invoice/{id}/pdf", async (int id, InvoiceService service) =>
{
    var invoice = await service.GetInvoiceAsync(id);
    var renderer = new ChromePdfRenderer();

    var pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml());

    return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
});

app.Run();

using IronPdf;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/invoice/{id}/pdf", async (int id, InvoiceService service) =>
{
    var invoice = await service.GetInvoiceAsync(id);
    var renderer = new ChromePdfRenderer();

    var pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml());

    return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
});

app.Run();

컨트롤러 패턴을 사용하는 팀의 경우, 동일한 코드는 컨트롤러 동작 내에서 작동합니다 — RenderHtmlAsPdf는 .BinaryData로 바이트로 변환할 수 있는 PdfDocument를 반환합니다.

라이선싱: $749부터 시작하는 영구 라이선스 (Lite — 1 개발자, 1 프로젝트). Professional: $1,499 (10 개발자). Enterprise: $2,999 (무제한). ironpdf.com에서 발행되었습니다.

QuestPDF— .NET 8 호환, HTML 없음

QuestPDF는 플랫폼 종속성 없이 .NET 8과 호환됩니다. 그의 유창한 C# API는 HTML 파서, CSS 엔진, 브라우저 엔진 없이 문서를 프로그래밍 방식으로 작성합니다:

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

QuestPDF.Settings.License = LicenseType.Community; // Free under $1M revenue

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Content().Column(col =>
        {
            col.Item().Text("Q4 Report").FontSize(24).Bold();
            col.Item().Table(table =>
            {
                table.ColumnsDefinition(c => { c.RelativeColumn(2); c.RelativeColumn(1); c.RelativeColumn(1); });
                table.Header(h =>
                {
                    h.Cell().Text("Metric").Bold();
                    h.Cell().Text("Value").Bold();
                    h.Cell().Text("Change").Bold();
                });
                table.Cell().Text("Revenue"); table.Cell().Text("$1.2M"); table.Cell().Text("+12%");
                table.Cell().Text("Users"); table.Cell().Text("45,230"); table.Cell().Text("+23%");
            });
        });
    });
}).GeneratePdf("report.pdf");

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

QuestPDF.Settings.License = LicenseType.Community; // Free under $1M revenue

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Content().Column(col =>
        {
            col.Item().Text("Q4 Report").FontSize(24).Bold();
            col.Item().Table(table =>
            {
                table.ColumnsDefinition(c => { c.RelativeColumn(2); c.RelativeColumn(1); c.RelativeColumn(1); });
                table.Header(h =>
                {
                    h.Cell().Text("Metric").Bold();
                    h.Cell().Text("Value").Bold();
                    h.Cell().Text("Change").Bold();
                });
                table.Cell().Text("Revenue"); table.Cell().Text("$1.2M"); table.Cell().Text("+12%");
                table.Cell().Text("Users"); table.Cell().Text("45,230"); table.Cell().Text("+23%");
            });
        });
    });
}).GeneratePdf("report.pdf");

QuestPDF는 HTML을 변환하지 않습니다. 워크플로우가 HTML 템플릿(Razor 뷰, 대시보드 내보내기, 웹 콘텐츠 아카이빙)을 사용하는 경우, 다른 라이브러리가 필요합니다. 커뮤니티 라이선스는 연간 수익 $1M 이하의 비즈니스를 커버합니다; 이를 초과하는 경우, 상용 라이선스가 필요합니다.

iText 7— .NET 8 호환, AGPL 라이선스

iText 7 (iTextSharp의 후속)은 .NET 8을 지원합니다. pdfHTML 애드온은 사용자 지정 파서로 HTML을 PDF로 변환합니다 - 브라우저 엔진이 아닙니다, 따라서 현대의 CSS 기능(플렉스박스, 그리드)은 올바르게 렌더링되지 않습니다.

라이선싱: AGPL 오픈 소스 사용 용, 상용 라이선싱 (구독, 가격 미공개) 는 독점 응용 프로그램 용. iText는 2024년에 구독 기반 상용 라이선스로 전환되었습니다.

표준 Debian 이미지 (권장)

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["MyApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app

#IronPDFworks without additional apt-get installs
# Chromium dependencies are handled internally

COPY --from=build /app/publish .

ENV DOTNET_RUNNING_IN_CONTAINER=true
EXPOSE 8080
ENTRYPOINT ["dotnet", "MyApp.dll"]

Alpine 이미지 (더 작은 발자국)

FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine AS build
WORKDIR /src
COPY ["MyApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine
WORKDIR /app

# Alpine requires explicit Chromium dependencies
RUN apk add --no-cache chromium nss freetype harfbuzz ca-certificates ttf-freefont

COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyApp.dll"]

Debian 이미지는 추가 패키지가 필요하지 않습니다. Alpine 이미지는 더 작지만 명시적인 Chromium 라이브러리 설치가 필요합니다. 대부분의 배포에서는 표준 Debian 이미지가 더 간단하고 신뢰할 만합니다.

iTextSharp에서 IronPDF로

// Before (iTextSharp — doesn't compile against net8.0)
using iTextSharp.text;
using iTextSharp.text.pdf;

var doc = new Document();
PdfWriter.GetInstance(doc, new FileStream("output.pdf", FileMode.Create));
doc.Open();
doc.Add(new Paragraph("Hello World"));
doc.Close();

// After (IronPDF — targets net8.0)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<p>Hello World</p>");
pdf.SaveAs("output.pdf");

// Before (iTextSharp — doesn't compile against net8.0)
using iTextSharp.text;
using iTextSharp.text.pdf;

var doc = new Document();
PdfWriter.GetInstance(doc, new FileStream("output.pdf", FileMode.Create));
doc.Open();
doc.Add(new Paragraph("Hello World"));
doc.Close();

// After (IronPDF — targets net8.0)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<p>Hello World</p>");
pdf.SaveAs("output.pdf");

wkhtmltopdf 래퍼에서 IronPDF로

// Before (DinkToPdf — DllNotFoundException on .NET 8)
var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument
{
    Objects = { new ObjectSettings { HtmlContent = html } }
};
var bytes = converter.Convert(doc);

// After (IronPDF — native .NET 8 support)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var bytes = pdf.BinaryData;

// Before (DinkToPdf — DllNotFoundException on .NET 8)
var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument
{
    Objects = { new ObjectSettings { HtmlContent = html } }
};
var bytes = converter.Convert(doc);

// After (IronPDF — native .NET 8 support)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var bytes = pdf.BinaryData;

API 표면은 두 경우 모두 더 단순합니다. 기본적인 이전 비용은 새로운 렌더러에 대한 기존 HTML 템플릿을 테스트하여 출력이 기대에 부합하는지 확인하는 것입니다.