# Falha do Chrome Renderer no Início a Frio no Azure App Service Linux
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:
```txt
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:
```csharp
Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();
```
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](/get-started/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.
[[n:(Este 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.)]]
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
libnss3.so: cannot open shared object file: No such file or directory
Text
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:
Option Strict On
Option Infer On
Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()
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.
Importante: Este 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 é 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 bem estruturados e visualmente atraentes.
