IRONSOFTWAREHOME

502 Bad Gateway no Azure

Curtis Chau
Curtis Chau
Updated: 24 de abril de 2026

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;

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 bem estruturados e visualmente atraentes.

...
Leia mais

Pronto para começar?

Nuget Downloads 20,756,830Versão:2026.7recém-lançado

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.
Biblioteca NuGet C# para PDF
Instalar com NuGet

Versão: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e pesquise "IronPDF".
  3. Selecione o pacote e instale.
DLL de PDF em C#
Baixar DLL

Versão: 2026.7

ou faça o download do Windows Installer aqui .

  1. Baixe e descompacte o IronPDF em um local como ~/Libs dentro do diretório da sua solução.
  2. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em Referências. Selecione Procurar e digite "IronPDF.dll".

Licenças a partir de US$ 749

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.