IRONSOFTWAREHOME

리눅스에서 디버거가 연결된 상태에서 PDF가 충돌, 멈춤 또는 빈 화면이 나타남

Curtis Chau
Curtis Chau
Updated: 2026년 7월 3일

리눅스에서는 애플리케이션에 디버거를 연결하면 IronPDF가 멈추거나 빈 PDF를 반환하거나 조용히 충돌할 수 있습니다. 이는 리눅스 배포판이나 .NET 버전에 관계없이 디버거가 연결될 때마다 발생합니다.

IronPDF는 CEF (Chromium Embedded Framework)를 통해 렌더링을 하며, 기본적으로 렌더링을 처리하기 위해 별도이고 샌드박스된 하위 프로세스를 생성합니다. 리눅스에서는 이러한 하위 프로세스가 ptrace으로 추적될 수 없도록 잠겨 있으며, 한 번에 하나의 트레이서만 가질 수 있습니다. 디버거를 연결하면 Chromium이 샌드박스된 하위 프로세스를 시작하는 방식과 충돌하여 렌더러 하위 프로세스가 멈춥니다. 귀하의 애플리케이션은 이를 멈춤, 빈 PDF 또는 조용한 충돌로 인식합니다.

해결책

추천: 단일 프로세스 모드를 활성화하세요. 첫 번째 IronPDF 작동 전에 애플리케이션 시작 시 설정하세요:

IronPdf.Installation.SingleProcess = true;

단일 프로세스 모드는 렌더링을 메인 프로세스에서 유지하여, 디버거와 충돌할 수 있는 샌드박스된 하위 프로세스가 없습니다.

이 설정은 CEF의 프로세스 격리를 비활성화하고, 부하가 걸릴 때 덜 안정적이므로, 프로덕션에서는 사용하지 마세요. 디버그 빌드에만 적용하여 릴리스에는 보내지 않도록 하세요:

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif
C#
경고: 단일 프로세스 모드는 CEF의 프로세스 격리를 비활성화하고, 부하가 걸릴 때 덜 안정적입니다. 배포 전에 릴리스 빌드에서 제거하거나 제외하세요.
Curtis Chau
기술 문서 작성자

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

...
더 읽어보기

시작할 준비 되셨나요?

Nuget Downloads 21,253,952버전:2026.10방금 출시

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

버전: 2026.10

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

버전: 2026.10

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

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

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

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의 고객 로고
부담 없는 무료 상담을 받아보세요
고객님의 정보는 항상 비밀로 유지됩니다.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.
PDF용 C# NuGet 라이브러리
NuGet을 사용하여 설치하세요

버전: 2026.10

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

버전: 2026.10

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

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

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