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

Curtis Chau
Curtis Chau
Updated: 10 de junio de 2026

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/
Text

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;

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";

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
SHELL

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

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.

Importante: Este 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 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 estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Nuget Downloads 21,739,885Versión:2026.10recién publicada