IRONSOFTWAREHOME

Azure에서 502 Bad Gateway 오류가 발생했습니다.

Curtis Chau
Curtis Chau
Updated: 2026년 4월 24일

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;

기본적으로 IronPDF 멀티 프로세스 소프트웨어 모듈로 실행되며, HTML 렌더링, URL 요청 전송 등 주어진 작업에 따라 새로운 프로세스를 생성합니다. 이로 인해 IronPDF 내결함성을 갖추게 되지만, 제약이 있는 환경에서는 제대로 실행될 가능성이 낮아집니다. 위 옵션을 설정하면 IronPDF 단일 프로세스로 실행됩니다. 이로 인해 내결함성은 떨어지지만, 제약이 있는 환경에서 라이브러리가 제대로 실행될 가능성이 높아집니다.

이러한 "상충 관계" 때문에, 이 방법을 시도하기 전에 위의 두 가지 방법을 먼저 시도해 보시는 것을 권장합니다 .

4. 애플리케이션을 컨테이너화하세요

Azure 시스템의 변경 사항이 IronPDF 에 영향을 미치지 않도록 하려면 애플리케이션을 Docker 로 컨테이너화하십시오.

Docker를 사용하여 IronPDF 컨테이너화하는 방법에 대한 자세한 내용은 다음 링크를 참조하십시오.

그래도 작동하지 않나요?

위의 모든 방법을 시도해 보았는데도 애플리케이션에서 여전히 502 Bad Gateway 오류가 발생하는 경우 support@ironsoftware.com 으로 문의해 주세요.

지원 요청 방법을 알아보려면 이 링크를 클릭하고, Azure에서 로그 파일을 가져오는 방법을 알아보려면 이 링크를 클릭하세요.

Curtis Chau
기술 문서 작성자

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

...
더 읽어보기

시작할 준비 되셨나요?

Nuget Downloads 20,756,830버전:2026.7방금 출시

지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.
PDF용 C# NuGet 라이브러리
NuGet을 사용하여 설치하세요

버전: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭하고 NuGet 패키지 관리를 선택합니다.
  2. 찾아보기를 선택하고 "IronPDF"를 검색하세요.
  3. 패키지를 선택하고 설치하세요
C# PDF DLL
DLL 다운로드

버전: 2026.7

또는 여기에서 Windows 설치 프로그램을 다운로드하십시오.

  1. IronPDF를 다운로드하고 솔루션 디렉터리 내의 ~/Libs와 같은 위치에 압축을 푸세요.
  2. Visual Studio 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다. 찾아보기를 선택하고 "IronPDF.dll"을 선택합니다.

라이선스 가격은 749달러 부터 시작합니다.

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.