1. IronPDF
  2. Solução de problemas
  3. Problema de dependência do IronPDF Ubuntu 24.04 no .NET 9 e .NET 10

Problema de Dependência do IronPDF no Ubuntu 24.04 no .NET 9 e .NET 10

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

No Ubuntu 24.04 com .NET 9 ou .NET 10, o IronPDF não consegue instalar suas dependências de sistema necessárias na inicialização. Isso afeta imagens do Azure Linux e ambientes Linux não-Docker onde o aplicativo não é executado com privilégios de raiz.

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

O Ubuntu 24.04 renomeou a biblioteca de áudio de libasound2 para libasound2t64. O instalador automático de dependências do IronPDF tem como alvo o nome do pacote original libasound2 e não pode adquirir o bloqueio APT ao ser executado como um usuário não raiz, produzindo o erro de permissão mostrado acima.

Solução

Opção 1: Ativar configuração automática de dependências (Docker e Azure Linux)

Defina LinuxAndDockerDependenciesAutoConfig para true antes da primeira chamada de renderização:

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True
$vbLabelText   $csharpLabel

Para capturar a saída de diagnóstico durante a inicialização, ative o registro de arquivos:

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

Opção 2: Primeira execução com privilégios elevados (Linux não-Docker)

Para ambientes Linux não-Docker, execute o aplicativo uma vez com privilégios elevados para que o IronPDF possa instalar os pacotes necessários.

sudo -E dotnet run
sudo -E dotnet run
SHELL

Se dotnet não for encontrado sob sudo, use o caminho completo:

sudo -E ~/.dotnet/dotnet run
sudo -E ~/.dotnet/dotnet run
SHELL

Após a primeira execução instalar as dependências, execuções subsequentes não requerem privilégios elevados. Para a lista completa de pacotes necessários no Ubuntu 24.04, veja o guia de implantação do Linux.

(Este problema foi resolvido no IronPDF 2026.3.x. Atualizar para essa versão ou posterior significa que a renomeação da biblioteca libasound2t64 é detectada automaticamente sem exigir configuração manual.)

Curtis Chau
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 ...

Leia mais
Pronto para começar?
Nuget Downloads 20,088,359 | Versão: 2026.7 recém-lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.