Linux 및 WSL에서 라이선스 키 없이 발생하는 Win32Exception

업데이트됨:6월 9, 2026

Translated

View the article in English

IronPDF를 Ubuntu, WSL에서 실행하거나 라이선스 키 없이 Docker 컨테이너에서 실행할 때, 애플리케이션은 xdg-open을/를 참조하는 예외를 던집니다.

System.ComponentModel.Win32Exception: An error occurred trying to start process 'xdg-open' with working directory '/path/to/your/project/bin/Debug/net7.0'. No such file or directory

이 오류가 발생하려면 세 가지 조건이 동시에 존재해야 합니다: Linux 또는 WSL에서 실행, IronPDF 라이선스 키가 구성되지 않음, 그리고 xdg-open이 설치되어 있지 않음. 라이선스 키가 없을 경우, IronPDF는 xdg-open을 사용하여 체험판 공지를 표시하기 위해 브라우저를 열려고 시도합니다. 이 유틸리티는 최소한의 Linux 환경에서는 존재하지 않으므로 Win32Exception이 발생합니다.

해결책

단계 1: 라이선스 키 설정

어떠한 PDF 렌더링 호출 전에 라이선스 키를 구성하십시오:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

$vbLabelText $csharpLabel

체험 키도 문제를 해결합니다. 유효한 라이선스 키를 설정하면 IronPDF의 브라우저 열기 시도를 방지할 수 있습니다.

단계 2: xdg-utils 설치

라이선스 키 없이 실행하거나 종속성을 제거하려면:

sudo apt update
sudo apt install xdg-utils

sudo apt update
sudo apt install xdg-utils

SHELL

전체 Linux 및 WSL 설정은 Linux 배포 가이드를 참조하십시오.

Curtis Chau

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

기술 문서 작성자

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

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?

Nuget 다운로드 20,088,359 | 버전: 2026.7 방금 출시