매우 큰 PDF에서 느린 스탬핑

Curtis Chau
Curtis Chau
업데이트됨: 2026년 10월 19일

매우 큰 PDF의 모든 페이지를 한 번에 스탬핑하면 작업이 진행되면서 점점 더 느려집니다. 보고된 20,000페이지의 경우, 병목 현상은 문서를 분할하는 데 사용된 방법에 있었으며, 스탬핑 작업 자체는 아니었습니다.

엔지니어링 팀은 20,000페이지 사례에서 느려짐을 스탬핑 작업보다는 문서 분할 방법으로 추적했습니다. 상세한 메커니즘은 개발자 노트에서 독립적으로 확인되지 않았습니다.

해결 방법은 PDF를 작게 부분적으로 재귀적으로 분할하여 각 부분에 스탬프를 적용하고(필요시 병렬 작업 프로세스에서) 결과를 하나의 파일로 병합하는 것입니다.

해결책

1. 원본 PDF를 재귀적으로 분할

권장: 각 부분이 목표 페이지 수 이하가 될 때까지 계속 분할하십시오. 각 부분을 디스크에 저장하여 메모리 사용량을 낮게 유지하고 작업자가 파일을 독립적으로 가져갈 수 있게 합니다. 파일 이름은 부분의 첫 번째 페이지를 저장하며, 이는 부분을 순서대로 유지하고 나중에 페이지 의존 스탬프를 지원합니다.

using IronPdf;
using IronPdf.Editing;
static void SplitToFiles(PdfDocument doc, int startPage, int targetPages,
                         string outDir, List<string> files)
{
    if (doc.PageCount <= targetPages)
    {
        // File name carries the chunk's first page (1-based).
        string path = Path.Combine(outDir, $"chunk_{startPage:D6}.pdf");
        doc.SaveAs(path);
        files.Add(path);
        return;
    }
    int mid = doc.PageCount / 2;
    using (var left = doc.CopyPages(0, mid - 1))
        SplitToFiles(left, startPage, targetPages, outDir, files);
    using (var right = doc.CopyPages(mid, doc.PageCount - 1))
        SplitToFiles(right, startPage + mid, targetPages, outDir, files);
}
// Usage
var chunkFiles = new List<string>();
using (var source = PdfDocument.FromFile("input.pdf"))
    SplitToFiles(source, 1, 500, @"C:\temp\chunks", chunkFiles);
C#

500의 부분 크기는 시작점입니다. 문서 및 하드웨어에 맞게 조정하십시오.

2. 각 부분에 스탬핑

각 부분을 열고 스탬프를 적용한 후 결과를 새 파일에 저장합니다.

var stamper = new HtmlStamper("<div style='font-size:24px;color:red'>CONFIDENTIAL</div>")
{
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center,
    Opacity = 50
};
var stampedFiles = new List<string>();
foreach (string file in chunkFiles)
{
    string outPath = file.Replace(".pdf", "_stamped.pdf");
    using (var chunk = PdfDocument.FromFile(file))
    {
        chunk.ApplyStamp(stamper);
        chunk.SaveAs(outPath);
    }
    stampedFiles.Add(outPath);
}
C#

3. 동시로 부분 처리

선택 사항: 각 작업 프로세스에 부분 목록의 고유한 부분을 제공합니다. 벤치마크에서는 16코어 기계에서 8개의 작업 프로세스를 사용했습니다. 하드웨어에 맞게 작업자 수를 조정하십시오.

// In each worker process: workerIndex = 0..workerCount-1
var mySlice = chunkFiles.Where((f, i) => i % workerCount == workerIndex);
C#

4. 스탬핑된 부분을 순서대로 병합

var parts = stampedFiles.OrderBy(f => f)
                        .Select(f => PdfDocument.FromFile(f))
                        .ToList();
using (var merged = PdfDocument.Merge(parts))
{
    merged.SaveAs("output.pdf");
}
parts.ForEach(p => p.Dispose());
C#

임시 부분 파일을 완료했을 때 삭제하십시오.

5. 예상 시간

대략적인 지침으로 20,000페이지 벤치마크 결과:

  • 분할: 약 6분
  • 스탬핑 및 병합, 단일 프로세스: 약 6분
  • 스탬핑 및 병합, 8개 프로세스: 약 1.5분
  • 전체 병렬 실행: 약 8분

분할이 가장 큰 비용입니다. 만약 PDF를 직접 생성한다면 처음부터 부분으로 만들어 분할을 생략하는 것을 고려하십시오.

6. 다른 페이지 수준 작업에서도 동일한 패턴 재사용

분할, 처리, 병합은 각 페이지를 독립적으로 처리하는 모든 작업에서 작동합니다. 적합한 사례:

  • 텍스트, 이미지, HTML, 바코드 스탬프, 워터마크
  • HTML 헤더와 푸터 (번호가 연속되도록 FirstPageNumber 설정)
  • 모든 페이지에서 텍스트 제거
  • 텍스트 찾아 바꾸기
  • 이미지 압축 및 형식 평면화
  • 배경, 전경, 페이지 회전

바테스 번호나 페이지 레이블과 같은 페이지 의존적 스탬프는 각 부분의 글로벌 시작 페이지가 필요합니다. 부분 파일 이름에서 읽어 들이십시오:

int firstPage = int.Parse(Path.GetFileNameWithoutExtension(file).Split('_')[1]);
for (int i = 0; i < chunk.PageCount; i++)
{
    var bates = new TextStamper { Text = $"ABC{firstPage + i:D7}" };
    chunk.ApplyStamp(bates, i);
}
C#

첫 번째 페이지 번호는 chunk_NNNNNN.pdf 이름에서 다시 구문 분석된 후 각 페이지는 그 글로벌 시작에서 스탬프 오프셋을 받습니다.

분할만, 병합 필요 없음:

  • 검색 인덱싱을 위한 텍스트 추출
  • 이미지를 위한 페이지 래스터화
  • OCR 준비를 위한 페이지

병합 후 실행, 각 부분별로 실행하지 않음:

  • 디지털 서명 (병합이 문서를 변경하고 부분별 서명을 깨뜨림)
  • 암호, 권한 및 암호화
  • 북마크, 개요 및 목차
  • 문서 메타데이터
  • PDF/A 또는 PDF/UA 변환
경고: 병합된 부분은 글꼴과 같은 공유 리소스를 반복할 수 있습니다. 출력 크기를 원본과 비교하고 필요한 경우 최종 파일을 압축하십시오.

일반 사용 사례:

  • 법적 발견 세트를 위한 바테스 번호 매김
  • 대규모 아카이브에 기밀 또는 초안 워터마크 추가
  • 메일 분류를 위한 바코드가 있는 일괄 문서 또는 송장
  • 내보낸 기록에서 개인 데이터 삭제
  • 장기 저장 전 스캔된 아카이브 줄이기

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

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 22,198,312버전:2026.11방금 출시