502 Bad Gateway no Azure

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

O erro 502 Bad Gateway é um código de status HTTP que geralmente indica que um servidor de gateway recebeu uma resposta incorreta de outro servidor. Em relação ao IronPDF, esse erro pode ocorrer quando implantado no Azure.

Neste artigo, você encontrará diversas sugestões sobre como resolver esse erro no Azure.

1. Desmarque a opção "Executar a partir do arquivo de pacote".

Ao implantar seu aplicativo no Azure usando o Visual Studio, você verá a opção "Executar a partir de um arquivo de pacote" . Certifique-se de que esta opção esteja desmarcada antes de implantar seu aplicativo no Azure. Você também pode definir WEBSITE_RUN_FROM_PACKAGE = 0 nas configurações do seu aplicativo.

Para obter mais informações sobre como executar seu aplicativo a partir de um arquivo de pacote, consulte a documentação oficial da Microsoft.

2. Alterar a região

Em alguns casos, os sistemas de certas regiões do Azure são atualizados, causando conflitos com o IronPDF. Se possível, implemente novamente sua aplicação em outra região.

3. Configure para executar no modo de processo único.

No seu código, adicione a seguinte linha à sua aplicação e faça a reimplementação:

// Set IronPDF to run in single process mode
Installation.SingleProcess = true;
// Set IronPDF to run in single process mode
Installation.SingleProcess = true;
' Set IronPDF to run in single process mode
Installation.SingleProcess = True
$vbLabelText   $csharpLabel

Por padrão, o IronPDF é executado como um módulo de software multiprocesso, criando um novo processo para qualquer tarefa que lhe seja atribuída (seja renderizar HTML, enviar uma solicitação de URL, etc.). Isso torna o IronPDF tolerante a falhas, mas menos propenso a funcionar corretamente em ambientes com recursos limitados. Ao ativar a opção acima, o IronPDF será executado como um processo único, o que reduzirá sua tolerância a falhas, mas aumentará a probabilidade de a biblioteca funcionar corretamente em ambientes com recursos limitados.

Devido a essa "disposição", recomendamos experimentar primeiro as duas sugestões acima antes de tentar esta.

4. Containerize sua aplicação

Para garantir que nenhuma alteração no sistema Azure interfira com o IronPDF, conteinere sua aplicação com o Docker .

Você pode aprender mais sobre como conteinerizar o IronPDF com o Docker seguindo este link .

Ainda não funciona?

Se você já tentou todas as sugestões acima e seu aplicativo ainda está apresentando o erro 502 Bad Gateway , entre em contato conosco pelo endereço support@ironsoftware.com .

Para aprender como fazer uma solicitação de suporte, siga este link e, para aprender como recuperar arquivos de log do Azure, siga este link .

Curtis Chau
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 18,318,263 | Versão: 2026.4 acaba de ser 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.