IRONSOFTWAREHOME

IronPDF 에서 Chrome 종속성 문제 해결

Curtis Chau
Curtis Chau
Updated: 2026년 4월 22일

Google Chromium HTML 렌더러는 IronPDF의 "HTML을 PDF로 변환" 프로세스에서 필수적인 부분입니다. 이 렌더러에 필요한 바이너리 파일은 IronPDF NuGet 패키지 내에서 쉽게 찾을 수 있습니다. 프로젝트 폴더에 이 바이너리 파일이 없으면 다음과 같은 오류가 발생합니다.

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'.
Text

IronPDF Chrome 종속성을 자동으로 배포할 수 없는 경우 NuGet 통해 프로젝트에 수동으로 추가해야 할 수 있습니다. 여러 종속성을 추가할 수 있습니다.

참고해 주세요: IronPDF 의 최신 버전에서는 프로젝트 폴더에 필요한 바이너리가 없는 경우 런타임에 사용되는 운영 체제에 따라 NuGet 소스에서 필요한 바이너리가 자동으로 다운로드됩니다. 이 방법은 프로젝트가 인터넷에 연결되어 있고 프로젝트 폴더에 대한 읽기, 쓰기 및 실행 권한이 있는 한 성공적으로 작동합니다.

Windows 환경에서는 대상 운영 체제에 Visual C++ 런타임이 설치되어 있는지 확인하는 것이 좋습니다. 많은 최신 애플리케이션은 이 필수 운영 체제 구성 요소 없이는 실행될 수 없습니다.

리눅스Docker 에 대한 호환성 가이드도 제공합니다.

리눅스

  • 올바른 Docker 파일이 사용되고 있는지 확인하십시오.

  • IronPdf.Linux NuGet 패키지를 IronPDF 대신 사용하십시오.

  • Chrome 렌더링의 GPU 모드를 사용 안 함으로 설정하세요.

    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
  • Linux 및 Docker 종속성에 대한 자동 구성을 비활성화합니다.

    csharp
    Installation.LinuxAndDockerDependenciesAutoConfig = false;

"## MacOS"

  • .NET 런타임이 올바른 아키텍처(x64 또는 arm64)로 설정되어 있는지 확인하십시오.

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

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

배포할 운영 체제/플랫폼에 대해 꼭 알려주세요. 특히 AWS나 Azure 같은 클라우드 플랫폼인 경우에는 더욱 중요합니다.

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

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

(2021.3.1 이후 모든 버전) IronPDF 메서드를 실행하기 전에 코드 맨 위에 다음 코드를 추가하십시오.

// Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

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

  • default.log (배포 프로세스)
  • cef.log (렌더링)
  • IronSoftwareCefSubprocess.log (렌더링 및 스레딩)
  • IronSoftwareEngine.log ("PDF 생성 오류..."로 시작하는 예외를 디버깅하는 데 유용합니다.)

클라우드 서버는 종종 로그 파일을 저장하는 특정 위치를 가지고 있습니다. AzureAWS 에서 로그 파일을 생성하는 방법에 대한 가이드가 있습니다.

Curtis Chau
기술 문서 작성자

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

...
더 읽어보기

시작할 준비 되셨나요?

Nuget Downloads 20,756,830버전:2026.7방금 출시

지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.
PDF용 C# NuGet 라이브러리
NuGet을 사용하여 설치하세요

버전: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭하고 NuGet 패키지 관리를 선택합니다.
  2. 찾아보기를 선택하고 "IronPDF"를 검색하세요.
  3. 패키지를 선택하고 설치하세요
C# PDF DLL
DLL 다운로드

버전: 2026.7

또는 여기에서 Windows 설치 프로그램을 다운로드하십시오.

  1. IronPDF를 다운로드하고 솔루션 디렉터리 내의 ~/Libs와 같은 위치에 압축을 푸세요.
  2. Visual Studio 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다. 찾아보기를 선택하고 "IronPDF.dll"을 선택합니다.

라이선스 가격은 749달러 부터 시작합니다.

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.