파일 경로나 URL로 이미지를 참조하는 PDF는 숨겨진 종속성을 가집니다. 문서가 이를 생성한 기계를 떠나거나, 상태 비저장 클라우드 함수에서 실행되거나, 수년 간 보관될 경우, 이러한 참조는 깨질 수 있으며 로고나 차트가 있어야 할 곳에 빈 상자가 남을 수 있습니다. 이미지를 base64 데이터 URI로 HTML에 직접 임베드하면 해당 종속성이 제거되며, IronPDF는 결과를 완전한 독립형 PDF로 렌더링합니다.

비즈니스 문제

청구 서비스가 Azure 또는 AWS Lambda로 이동하면 파일 시스템 접근이 제한적이고 순간적으로 이루어져 현지에서 작동했던 이미지 경로가 더 이상 해결되지 않습니다. 보고 도구는 몇 년 후, 원본 자산 서버가 변경된 후에도 올바르게 표시되어야 하는 문서를 이메일로 보냅니다. 파이프라인은 런타임에 생성되어 디스크에 저장되지 않은 이미지로 문서를 구성합니다. 각 경우에 외부 이미지 참조는 책임 요소입니다.

데이터 URI로 이미지 임베드

패턴은 세 단계로 이루어집니다: 이미지 바이트를 읽고, 이를 base64로 변환하며, 결과를 일치하는 MIME 타입으로 <img> 태그에 넣습니다. 렌더링된 PDF는 파일 내부에 이미지를 보관합니다.

using IronPdf;
using System;

byte[] imageBytes = System.IO.File.ReadAllBytes("logo.png");
string dataUri = "data:image/png;base64," + Convert.ToBase64String(imageBytes);
string html = $"<img src='{dataUri}'>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("self-contained.pdf");

using IronPdf;
using System;

byte[] imageBytes = System.IO.File.ReadAllBytes("logo.png");
string dataUri = "data:image/png;base64," + Convert.ToBase64String(imageBytes);
string html = $"<img src='{dataUri}'>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("self-contained.pdf");

런타임에 생성된 이미지, 예를 들어 메모리에서 생성된 차트나 바코드에도 같은 방법이 작용합니다. 임시 파일을 작성하지 않고 바이트를 직접 인코딩하면 됩니다. 데이터 URI가 올바른 유형을 선언하는 한, PNG, JPEG, GIF, SVG (image/svg+xml), WebP와 같은 여러 형식을 지원합니다.

계획할 고려 사항

• Base64는 크기를 증가시킵니다: 인코딩은 각 이미지의 바이트 크기를 약 1/3 정도 증가시키며, 이는 HTML과 PDF에 모두 포함됩니다. 이미지가 많은 문서의 경우, 인코딩 전에 압축하거나 크기를 조정하고, 나중에 PDF 압축을 적용하세요.
• MIME 타입 일치: 접두사는 형식과 일치해야 하며, JPEG의 경우 data:image/jpeg;base64,와 같이 되어야 이미지가 렌더링됩니다.
• 파일 시스템 종속성 없음: 이미지는 문서 내부에 있으므로, 렌더는 접근 가능한 경로나 자산 서버에 의존하지 않습니다. 이것이 클라우드 및 컨테이너 배포에서 신뢰성을 가지게 만드는 이유입니다.
• 가져오기 횟수 감소: 인라인 이미지는 렌더링 중 추가 HTTP 또는 파일 시스템 호출을 피하여 문서에 많은 작은 이미지가 포함될 때 처리량을 높이는 데 도움이 됩니다.

결과

이미지를 데이터 URI로 임베드하면, 팀은 노트북에서 실행되든 서버리스 함수에서 실행되든 동일하게 렌더링되는 PDF를 생성할 수 있으며, 이메일로 보내거나 보관할 때 모든 이미지를 온전히 유지합니다. 전체 형식 세부사항과 예제는 DataURIs 가이드로 이미지 임베드하기에 있습니다.