Azure에서 502 Bad Gateway 오류가 발생했습니다.
502 Bad Gateway 오류는 일반적으로 게이트웨이 서버가 다른 서버로부터 잘못된 응답을 수신했음을 나타내는 HTTP 상태 코드입니다. IronPDF 와 관련하여, 이 오류는 Azure에 배포할 때 발생할 수 있습니다.
이 문서에서는 Azure에서 발생하는 이 오류를 해결하는 몇 가지 방법을 제시합니다.
1. "패키지 파일에서 실행" 옵션을 해제합니다.
Visual Studio에서 Azure에 애플리케이션을 배포할 때 "패키지 파일에서 실행" 옵션이 표시됩니다. Azure에 애플리케이션을 배포하기 전에 이 옵션이 선택 해제되어 있는지 확인하십시오. 응용 프로그램 설정에서 WEBSITE_RUN_FROM_PACKAGE = 0을 설정할 수도 있습니다.
패키지 파일에서 애플리케이션을 실행하는 방법에 대한 자세한 내용은 Microsoft의 공식 문서를 참조하십시오.
2. 지역 변경
때때로 특정 Azure 지역의 시스템이 업데이트되면서 IronPDF 와 충돌이 발생할 수 있습니다. 가능하다면 애플리케이션을 다른 지역에 배포하십시오.
3. 단일 프로세스 모드로 실행되도록 설정합니다.
코드에 다음 줄을 추가하고 애플리케이션을 다시 배포하세요.
// Set IronPDF to run in single process mode
Installation.SingleProcess = true;' Set IronPDF to run in single process mode
Installation.SingleProcess = True기본적으로 IronPDF 멀티 프로세스 소프트웨어 모듈로 실행되며, HTML 렌더링, URL 요청 전송 등 주어진 작업에 따라 새로운 프로세스를 생성합니다. 이로 인해 IronPDF 내결함성을 갖추게 되지만, 제약이 있는 환경에서는 제대로 실행될 가능성이 낮아집니다. 위 옵션을 설정하면 IronPDF 단일 프로세스로 실행됩니다. 이로 인해 내결함성은 떨어지지만, 제약이 있는 환경에서 라이브러리가 제대로 실행될 가능성이 높아집니다.
이러한 "상충 관계" 때문에, 이 방법을 시도하기 전에 위의 두 가지 방법을 먼저 시도해 보시는 것을 권장합니다 .
4. 애플리케이션을 컨테이너화하세요
Azure 시스템의 변경 사항이 IronPDF 에 영향을 미치지 않도록 하려면 애플리케이션을 Docker 로 컨테이너화하십시오.
Docker를 사용하여 IronPDF 컨테이너화하는 방법에 대한 자세한 내용은 다음 링크를 참조하십시오.
그래도 작동하지 않나요?
위의 모든 방법을 시도해 보았는데도 애플리케이션에서 여전히 502 Bad Gateway 오류가 발생하는 경우 support@ironsoftware.com 으로 문의해 주세요.
지원 요청 방법을 알아보려면 이 링크를 클릭하고, Azure에서 로그 파일을 가져오는 방법을 알아보려면 이 링크를 클릭하세요.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.