HTML 헤더/푸터로 InsertPdf 후 AccessViolationException

업데이트됨:6월 11, 2026

Translated

View the article in English

다른 문서에서 페이지를 병합하기 위해 InsertPdf를 사용한 후 PdfDocument의 AddHtmlHeadersAndFooters를 호출할 때 AccessViolationException이(가) 발생합니다. 디버그 빌드에서는 예외가 발생하지 않으며 디버거가 연결된 경우에도 발생하지 않습니다.

System.AccessViolationException: Attempted to read or write protected memory. This is often an indication that other memory is corrupt.
   at IronPdf.PdfDocument.AddHtmlHeadersAndFooters(...)

릴리스 빌드에서는 .NET JIT 최적화기가 관리된 코드에서 객체가 다시 참조되지 않을 것임을 증명할 수 있을 때 어휘 범위가 끝나기 전에 가비지 수집기가 관리 객체를 회수하도록 허용합니다. InsertPdf에 전달된 PdfDocument는 IronPDF의 네이티브 Chrome 레이어가 이를 읽고 있는 동안 회수될 수 있습니다. 이후의 AddHtmlHeadersAndFooters 호출에서 해제된 메모리에 접근하여 메모리 접근 위반을 일으킵니다.

솔루션

옵션 1: InsertPdf 전에 헤더와 푸터를 적용 (권장)

헤더와 푸터가 기본 문서에 페이지가 삽입되기 전에 작성되도록 작업 순서를 재조정합니다.

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:right; font-size:10px'>Page {page} of {total-pages}</div>"
};

var basePdf = renderer.RenderHtmlAsPdf(baseHtml);

basePdf.AddHtmlHeadersAndFooters(renderer.RenderingOptions);

var supplementPdf = PdfDocument.FromFile("supplement.pdf");
basePdf.InsertPdf(supplementPdf, 0);

basePdf.SaveAs("output.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:right; font-size:10px'>Page {page} of {total-pages}</div>"
};

var basePdf = renderer.RenderHtmlAsPdf(baseHtml);

basePdf.AddHtmlHeadersAndFooters(renderer.RenderingOptions);

var supplementPdf = PdfDocument.FromFile("supplement.pdf");
basePdf.InsertPdf(supplementPdf, 0);

basePdf.SaveAs("output.pdf");

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .HtmlFragment = "<div style='text-align:right; font-size:10px'>Page {page} of {total-pages}</div>"
}

Dim basePdf = renderer.RenderHtmlAsPdf(baseHtml)

basePdf.AddHtmlHeadersAndFooters(renderer.RenderingOptions)

Dim supplementPdf = PdfDocument.FromFile("supplement.pdf")
basePdf.InsertPdf(supplementPdf, 0)

basePdf.SaveAs("output.pdf")

$vbLabelText $csharpLabel

옵션 2: GC.KeepAlive 사용하여 조기 수집 방지

작업 순서를 변경할 수 없을 경우, 소스 PdfDocument의 관리 수명을 AddHtmlHeadersAndFooters 호출 이후까지 연장합니다.

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:right; font-size:10px'>Page {page} of {total-pages}</div>"
};

var basePdf = renderer.RenderHtmlAsPdf(baseHtml);
var supplementPdf = PdfDocument.FromFile("supplement.pdf");

basePdf.InsertPdf(supplementPdf, 0);
basePdf.AddHtmlHeadersAndFooters(renderer.RenderingOptions);

GC.KeepAlive(supplementPdf);

basePdf.SaveAs("output.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:right; font-size:10px'>Page {page} of {total-pages}</div>"
};

var basePdf = renderer.RenderHtmlAsPdf(baseHtml);
var supplementPdf = PdfDocument.FromFile("supplement.pdf");

basePdf.InsertPdf(supplementPdf, 0);
basePdf.AddHtmlHeadersAndFooters(renderer.RenderingOptions);

GC.KeepAlive(supplementPdf);

basePdf.SaveAs("output.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .HtmlFragment = "<div style='text-align:right; font-size:10px'>Page {page} of {total-pages}</div>"
}

Dim basePdf = renderer.RenderHtmlAsPdf(baseHtml)
Dim supplementPdf = PdfDocument.FromFile("supplement.pdf")

basePdf.InsertPdf(supplementPdf, 0)
basePdf.AddHtmlHeadersAndFooters(renderer.RenderingOptions)

GC.KeepAlive(supplementPdf)

basePdf.SaveAs("output.pdf")

$vbLabelText $csharpLabel

네이티브 병합이 완료되기 전에 supplementPdf의 JIT 수집을 AddHtmlHeadersAndFooters 뒤에 배치된 GC.KeepAlive(supplementPdf)이 방지합니다.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?

Nuget 다운로드 20,088,359 | 버전: 2026.7 방금 출시