Win32Exception en Linux y WSL Sin una Clave de Licencia

Actualizado:9 de junio de 2026

Translated

View the article in English

Al ejecutar IronPDF en Ubuntu, WSL o en un contenedor Docker sin una clave de licencia, la aplicación lanza una excepción que hace referencia a 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

Tres condiciones deben estar presentes simultáneamente para que ocurra este error: ejecutarse en Linux o WSL, no tener configurada una clave de licencia de IronPDF y xdg-open no está instalado. Sin una clave de licencia, IronPDF intenta abrir un navegador para mostrar un aviso de prueba usando xdg-open. La utilidad está ausente en entornos Linux mínimos, causando el Win32Exception.

Solución

Paso 1: Establece la clave de licencia

Configura la clave de licencia antes de cualquier llamada de renderizado de PDF:

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

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

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

$vbLabelText $csharpLabel

Una clave de prueba también resuelve el problema. Establecer una clave de licencia válida evita que IronPDF intente abrir un navegador.

Paso 2: Instalar xdg-utils

Si necesitas ejecutar sin una clave de licencia o deseas eliminar la dependencia:

sudo apt update
sudo apt install xdg-utils

sudo apt update
sudo apt install xdg-utils

SHELL

Para una configuración completa de Linux y WSL, consulta la guía de despliegue en Linux.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

¿Listo para empezar?

Nuget Descargas 20,088,359 | Versión: 2026.7 recién publicada