Problema de dependencia de IronPDF Ubuntu 24.04 en .NET 9 y .NET 10

Actualizado:9 de junio de 2026

Translated

View the article in English

En Ubuntu 24.04 con .NET 9 o .NET 10, IronPDF no logra instalar sus dependencias del sistema requeridas al inicio. Esto afecta las imágenes de Azure Linux y los entornos Linux no Docker donde la aplicación no se ejecuta con privilegios de root.

E: Could not open lock file /var/lib/apt/lists/lock - open (13: Permission denied)
E: Unable to lock directory /var/lib/apt/lists/

Ubuntu 24.04 renombró la biblioteca de audio de libasound2 a libasound2t64. El instalador automático de dependencias de IronPDF apunta al nombre original del paquete libasound2 y no puede adquirir el bloqueo de APT al ejecutarse como un usuario sin privilegios de root, produciendo el error de permiso mostrado arriba.

Solución

Opción 1: Habilitar la configuración automática de dependencias (Docker y Azure Linux)

Configure LinuxAndDockerDependenciesAutoConfig a true antes de la primera llamada de renderizado:

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

$vbLabelText $csharpLabel

Para capturar la salida de diagnóstico durante el inicio, habilita el registro en archivo:

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.File;
IronSoftware.Logger.LogFilePath = "ironpdf.log";

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.File;
IronSoftware.Logger.LogFilePath = "ironpdf.log";

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.File
IronSoftware.Logger.LogFilePath = "ironpdf.log"

$vbLabelText $csharpLabel

Opción 2: Primer lanzamiento con privilegios elevados (Linux no Docker)

Para entornos Linux no Docker, ejecuta la aplicación una vez con privilegios elevados para que IronPDF pueda instalar los paquetes requeridos:

sudo -E dotnet run

sudo -E dotnet run

SHELL

Si dotnet no se encuentra bajo sudo, use la ruta completa:

sudo -E ~/.dotnet/dotnet run

sudo -E ~/.dotnet/dotnet run

SHELL

Después de que el primer lanzamiento instale las dependencias, las ejecuciones posteriores no requieren privilegios elevados. Para la lista completa de paquetes requeridos en Ubuntu 24.04, consulta la guía de despliegue para Linux.

ImportanteEste problema se resolvió en IronPDF 2026.3.x. Actualizar a esa versión o posterior significa que el cambio de nombre de la biblioteca libasound2t64 se detecta automáticamente sin necesidad de configuración manual.

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