PDFium 종속성 오류 해결

Curtis Chau

Updated: 2026년 4월 24일

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Google PDFium은 IronPDF의 핵심 코드에서 필수적인 구성 요소로, PDF 편집 및 PDF 문서를 이미지로 변환하는 것과 관련된 다양한 기능에 활용됩니다. 프로젝트 폴더에 PDFium 바이너리가 없는 경우, 런타임 중에 다음 오류가 발생합니다.

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying Pdfium for IronPdf: 'Unable to locate 'IronPdfInterop'

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying Pdfium for IronPdf: 'Unable to locate 'IronPdfInterop'

일반적으로 프로젝트에 IronPdf.Native.PdfModel 패키지를 설치하면 이 문제가 해결됩니다.

Windows 환경에서는 대상 운영 체제에 Visual C++ 런타임이 설치되어 있는지 확인하는 것이 좋습니다.

그래도 문제가 해결되지 않으면 어떻게 해야 하나요?

그래도 문제가 해결되지 않는다면, 저희가 도와드리겠습니다. 호환성은 저희 엔지니어링 팀의 최우선 과제입니다. 버그 보고서는 이메일로 보내주십시오support@ironsoftware.com. 모든 호환성 문제는 선임 엔지니어가 철저히 검토할 것입니다.

배포 대상 운영 체제/플랫폼을 반드시 알려주시기 바랍니다. 특히 AWS나 Azure와 같은 클라우드 플랫폼인 경우 더욱 그렇습니다.

IronPDF에서 네이티브 로깅을 활성화하는 방법

버그 보고서에 로그 파일을 첨부하면 문제를 정확히 파악하고 신속하게 해결할 확률이 두 배 이상 높아집니다.

이 코드를 IronPDF 메서드(2021.3.1 이후 모든 버전)를 실행하기 전에 코드 상단에 배치하십시오.

// Enable debugging to generate detailed log files for troubleshooting.
IronPdf.Logging.Logger.EnableDebugging = true;

// Set the path for the log file. You can specify a directory name or a full file path.
IronPdf.Logging.Logger.LogFilePath = "Default.log";

// Set the logging mode to log all events.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

// Enable debugging to generate detailed log files for troubleshooting.
IronPdf.Logging.Logger.EnableDebugging = true;

// Set the path for the log file. You can specify a directory name or a full file path.
IronPdf.Logging.Logger.LogFilePath = "Default.log";

// Set the logging mode to log all events.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

' Enable debugging to generate detailed log files for troubleshooting.
IronPdf.Logging.Logger.EnableDebugging = True

' Set the path for the log file. You can specify a directory name or a full file path.
IronPdf.Logging.Logger.LogFilePath = "Default.log"

' Set the logging mode to log all events.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All

' Enable debugging to generate detailed log files for troubleshooting.
IronPdf.Logging.Logger.EnableDebugging = True

' Set the path for the log file. You can specify a directory name or a full file path.
IronPdf.Logging.Logger.LogFilePath = "Default.log"

' Set the logging mode to log all events.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All

IronPDF에서 생성된 로그 파일은 DLL이 배포된 프로젝트의 /bin 디렉터리에 있습니다:

• default.log (배포 프로세스)
• cef.log (렌더링)
• IronSoftwareCefSubprocess.log (렌더링 및 스레딩)
• IronSoftwareEngine.log ( "Error generating PDF from..."으로 시작하는 예외 디버깅에 유용함)

클라우드 서버는 종종 로그 파일을 저장하는 특정 위치를 지정합니다. Azure 및 AWS에서 로그 파일을 생성하는 방법에 대한 가이드가 준비되어 있습니다.

Curtis Chau

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

기술 문서 작성자

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

...

더 읽어보기