IRONSOFTWAREHOME

502 Bad Gateway en Azure

Curtis Chau
Curtis Chau
Updated: 24 de abril de 2026

El error 502 Bad Gateway es un código de estado HTTP que generalmente indica que un servidor intermediario recibió una respuesta defectuosa de otro servidor. En relación con IronPDF, este error puede ocurrir cuando se implementa en Azure.

En este artículo, encontrará varias sugerencias sobre cómo resolver este error en Azure.

1. Desactive la opción "Ejecutar desde archivo de paquete"

Al implementar su aplicación en Azure en Visual Studio, se le presentará una opción de Ejecutar desde el archivo de paquete. Asegúrese de que esta opción esté desmarcada antes de implementar su aplicación en Azure. También podría establecer WEBSITE_RUN_FROM_PACKAGE = 0 en la configuración de su aplicación.

Para obtener más información sobre cómo ejecutar su aplicación desde un archivo de paquete, consulte la documentación oficial de Microsoft.

2. Cambiar la región

A veces, los sistemas de ciertas regiones de Azure se actualizan, causando conflictos con IronPDF. Si es posible, vuelva a implementar su aplicación en otra región.

3. Configurado para ejecutarse en modo de proceso único

En su código, agregue la siguiente línea a su aplicación y vuelva a implementarla:

// Set IronPDF to run in single process mode
Installation.SingleProcess = true;

De forma predeterminada, IronPDF se ejecuta como un módulo de software de múltiples procesos, generando un nuevo proceso para cualquier tarea que se le asigne (ya sea renderizar HTML, enviar una solicitud de URL, etc.). Esto hace que IronPDF sea tolerante a fallos, pero menos probable de ejecutarse correctamente en entornos restringidos. Al establecer la opción anterior, IronPDF se ejecutará como un único proceso, lo que reducirá su tolerancia a fallos, pero mejorará la probabilidad de que la biblioteca funcione correctamente en entornos restringidos.

Debido a este "compromiso", recomendamos probar primero las dos sugerencias anteriores antes de intentar esta.

4. Containerice su aplicación

Para asegurar que ningún cambio en el sistema Azure altere IronPDF, contenga su aplicación con Docker.

Puede aprender más sobre cómo contener IronPDF con Docker en este enlace.

¿Aún no funciona?

Si ha probado todas las sugerencias anteriores y su aplicación aún arroja el error 502 Bad Gateway, contáctenos en support@ironsoftware.com.

Para aprender cómo realizar una solicitud de soporte, siga este enlace, y para aprender cómo recuperar archivos de registro de Azure, siga este enlace.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...
Leer más

¿Listo para empezar?

Nuget Downloads 21,105,021Versión:2026.9recién publicada

Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999

Key in blue circle

Obtenga su clave de prueba gratuita de 30 días al instante.

Your trial license will be sent to your email address

Sin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.

OR
bullet_checkedNo se requiere tarjeta de crédito ni creación de cuentaSin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Reserve su Demostración en Vivo gratuita
Booking Badge

Confiado por millones de ingenieros en todo el mundo

Logos de clientes de Iron Software
Obtén tu Consulta Sin Compromiso
Completa el formulario a continuación o envía un correo a sales@ironsoftware.com
Tus detalles siempre serán mantenidos confidenciales.
Confiado por millones de ingenieros en todo el mundo
Logos de clientes de Iron Software
Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999