1. IronPDF
  2. Solução de problemas
  3. Falhas no Renderizador do Chrome ao Iniciar a Frio no Azure App Service Linux

Falha do Chrome Renderer no Início a Frio no Azure App Service Linux

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

Este problema ocorre no Azure App Service Linux quando a imagem base Oryx/Ubuntu subjacente é atualizada pela Azure, removendo bibliotecas compartilhadas das quais o renderizador do Chrome do IronPDF depende. Durante o próximo início a frio, o IronPDF precisa reinstalar essas dependências nativas do Chrome do zero, um processo que pode levar até 5 minutos. Se o tempo limite de inicialização do aplicativo for muito curto, a instalação é interrompida e o renderizador falha.

O erro geralmente aparece como:

libnss3.so: cannot open shared object file: No such file or directory

A Azure atualiza periodicamente a imagem base usada pelos ambientes do App Service Linux. Essas atualizações podem remover bibliotecas compartilhadas como libnss3.so que o Chrome requer. Quando isso acontece, o mecanismo LinuxAndDockerDependenciesAutoConfig do IronPDF tenta reinstalar os pacotes necessários na inicialização. Se o tempo limite do serviço for menor que o tempo necessário para completar esta instalação, o processo é interrompido antes que o Chrome esteja pronto.

Este problema foi confirmado no seguinte ambiente:

  • Versão afetada: IronPDF 2026.4.1
  • Versão não afetada: IronPDF 2026.5.2
  • Hospedagem: Plano P0v3 do Azure App Service, região Leste da Noruega
  • Tempo de execução: .NET 10

Solução

Solução 1: Aplicar configurações de inicialização e aumentar o tempo limite de inicialização

Adicione o seguinte código de inicialização no início do aplicativo, antes de qualquer chamada de renderização de PDF:

Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();
Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();
Option Strict On



Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()
$vbLabelText   $csharpLabel

Configurar LinuxAndDockerDependenciesAutoConfig para true instrui o IronPDF a detectar e instalar automaticamente as dependências Linux ausentes. Configurar ChromeGpuMode para IronPdf.Engines.Chrome.ChromeGpuModes.Disabled desativa a aceleração GPU, que não está disponível nos ambientes Azure App Service Linux. Ativar o log completo ajuda a capturar quaisquer erros durante a etapa de instalação das dependências.

Em seguida, aumente o tempo limite de inicialização do Azure App Service para pelo menos 10 minutos. Isso dá ao IronPDF tempo suficiente para completar a reinstalação das dependências durante um início a frio após uma atualização de imagem base da Azure. Veja o guia de implementação no Azure para instruções sobre como ajustar a configuração do limite de tempo de inicialização no App Service.

Solução 2: Atualize para o IronPDF 2026.5.2 ou posterior

Atualizar para o IronPDF 2026.5.2 ou uma versão posterior resolve este problema. A versão não afetada lida com o caso em que as atualizações de imagem base da Azure removem bibliotecas compartilhadas sem causar falha no início a frio.

ImportanteEste problema foi resolvido no IronPDF 2026.5.2. Se você estiver nessa versão ou posterior, as soluções alternativas na Solução 1 não são mais necessárias.

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.