Win32Exception no Linux e WSL Sem Chave de Licença

Curtis Chau

Updated: 10 de junho de 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Win32Exception no Linux e WSL Sem Chave de Licença Ao executar o IronPDF no Ubuntu, WSL ou em um contêiner Docker sem uma chave de licença, o aplicativo lança uma exceção referenciando `xdg-open`. ```txt 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 ``` Três condições devem estar presentes simultaneamente para que este erro ocorra: rodando no Linux ou WSL, nenhuma chave de licença do IronPDF configurada e `xdg-open` não está instalado. Sem uma chave de licença, o IronPDF tenta abrir um navegador para exibir um aviso de teste usando `xdg-open`. A utilidade está ausente em ambientes Linux mínimos, causando o Win32Exception. ## Solução ### Passo 1: Defina a chave de licença Configure a chave de licença antes de qualquer chamada de renderização de PDF: ```csharp IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"; ``` Uma chave de teste também resolve o problema. Definir uma chave de licença válida impede que o IronPDF tente abrir um navegador. ### Passo 2: Instale xdg-utils Se você precisar executar sem uma chave de licença ou quiser eliminar a dependência: ```bash sudo apt update sudo apt install xdg-utils ``` Para configuração completa do Linux e WSL, veja o [guia de implantação do Linux](/get-started/linux/).

• ---

• 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

Ao executar o IronPDF no Ubuntu, WSL ou em um contêiner Docker sem uma chave de licença, o aplicativo lança uma exceção referenciando 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

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

Três condições devem estar presentes simultaneamente para que este erro ocorra: rodando no Linux ou WSL, nenhuma chave de licença do IronPDF configurada e xdg-open não está instalado. Sem uma chave de licença, o IronPDF tenta abrir um navegador para exibir um aviso de teste usando xdg-open. A utilidade está ausente em ambientes Linux mínimos, causando o Win32Exception.

Solução

Passo 1: Defina a chave de licença

Configure a chave de licença antes de qualquer chamada de renderização de PDF:

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

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

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

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

Uma chave de teste também resolve o problema. Definir uma chave de licença válida impede que o IronPDF tente abrir um navegador.

Passo 2: Instale xdg-utils

Se você precisar executar sem uma chave de licença ou quiser eliminar a dependência:

sudo apt update
sudo apt install xdg-utils

sudo apt update
sudo apt install xdg-utils

Para configuração completa do Linux e WSL, veja o guia de implantação do Linux.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...

Leia mais