Problemas de processamento de GPU no IronPDF: Soluções

Atualizado:agosto 20, 2025

Translated

View the article in English

[0110/094441.173:ERROR:network_service_instance_impl.cc(521)] Network service crashed, restarting service.
[0110/094442.261:ERROR:gpu_process_host.cc(990)] GPU process exited unexpectedly: exit_code=255
[0110/094442.261:WARNING:gpu_process_host.cc(1337)] The GPU process has crashed 3 time(s)
[0110/094442.261:FATAL:gpu_data_manager_impl_private.cc(440)] GPU process isn't usable. Goodbye.

Se você estiver vendo um erro semelhante ao acima ao usar o IronPDF, especialmente ao implantá-lo no Azure, saiba que não está sozinho. Sabe-se que esse erro causa o travamento do aplicativo e geralmente está relacionado ao IronCefSubprocess.exe localizado na pasta runtimes, que é um componente crucial do IronPDF.

Possíveis causas

Diversos fatores podem levar a esse erro no processo da GPU. Abaixo estão algumas das causas mais frequentes:

Ausência de permissões de execução para o subprocesso IronCef

O IronCefSubprocess.exe deve ter permissões de execução para que o IronPDF inicialize a classe ChromePdfRenderer corretamente.
Etapas incorretas de implantação no Azure

Os processos de implantação do IronPDF diferem entre Linux e Windows no Azure. Seguir os passos errados pode desencadear esse erro.
Dependências de DLL ausentes

IronCefSubprocess.exe requer determinados arquivos DLL para funcionar corretamente. A falta de DLLs, especialmente em ambientes que não sejam Windows, pode fazer com que o processo falhe.

Solução

Ambiente local

Se você estiver enfrentando esse erro localmente, tente os seguintes passos:

Desative o modo GPU

Adicione a seguinte linha ao seu código para desativar o modo GPU do IronPDF:

// Disables GPU mode to prevent issues with GPU process crashes
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

// Disables GPU mode to prevent issues with GPU process crashes
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

' Disables GPU mode to prevent issues with GPU process crashes
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

$vbLabelText $csharpLabel

Conceder permissões de execução

Certifique-se de que IronCefSubprocess.exe tenha permissões de execução. Para sistemas Linux, utilize o seguinte comando:

# Grants execute permissions to IronCefSubprocess.exe
chmod 755 IronCefSubprocess 
# You may need to specify an exact path
# IronCefSubprocess is typically found at bin/runtimes/linux-x64/
# chmod 755 /bin/runtimes/linux-x64/native/IronCefSubprocess
# In some cases you may need to use chmod 777 for broader permissions.

# Grants execute permissions to IronCefSubprocess.exe
chmod 755 IronCefSubprocess 
# You may need to specify an exact path
# IronCefSubprocess is typically found at bin/runtimes/linux-x64/
# chmod 755 /bin/runtimes/linux-x64/native/IronCefSubprocess
# In some cases you may need to use chmod 777 for broader permissions.

SHELL

Verifique se há DLLs ausentes

Se as etapas acima não resolverem o problema, execute manualmente IronCefSubprocess.exe para verificar se há DLLs ausentes. O sistema exibirá uma caixa de erro identificando a DLL ausente. Instale a DLL necessária e execute o aplicativo novamente.

Implantação no Azure

Se o erro ocorrer após a implantação do seu aplicativo no Azure, siga estas etapas:

Use o ZipDeploy

Implante sua aplicação usando o ZipDeploy para garantir que todos os arquivos sejam empacotados corretamente.
Desmarque a opção "Executar a partir do arquivo de pacote" .

Certifique-se de que a opção "Executar a partir do arquivo de pacote" esteja desmarcada durante a implantação.
Containerização para Linux

Se sua aplicação for destinada a um ambiente Linux, considere conteinerizá-la usando o Docker antes de implantá-la no Azure. Consulte o Guia de Configuração do Docker para obter instruções detalhadas.

Ative o Modo de Processo Único

Adicione o seguinte código para forçar o IronPDF a ser executado em modo de processo único:

// Forces IronPDF to run in single-process mode to improve stability on Azure
IronPdf.Installation.SingleProcess = true;

// Forces IronPDF to run in single-process mode to improve stability on Azure
IronPdf.Installation.SingleProcess = true;

' Forces IronPDF to run in single-process mode to improve stability on Azure
IronPdf.Installation.SingleProcess = True

$vbLabelText $csharpLabel

Caso nenhuma das soluções acima resolva o problema, envie uma solicitação de suporte técnico para obter ajuda personalizada.

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