메인 콘텐츠로 건너뛰기

빠른 답변

502는 일시적인 오류이므로 서버 측에서 구성을 변경할 필요가 없습니다.
  1. 근본 원인은 서비스 컨테이너의 자동 재시작입니다. 재시작 기간에는 웹 콘솔에 연결할 수 없고 API가 502를 반환하며, 이는 동일한 이벤트입니다.
  2. 일반적으로 1분 이내에 자동으로 복구됩니다. 30~60초 기다린 후 요청을 다시 전송하십시오.
  3. 실패한 호출에는 절대 과금되지 않습니다. 502가 발생하는 동안에는 요청이 실제로 서비스에 도달하지 않으므로 과금 기록이 생성되지 않습니다.
  4. 클라이언트 측에서 자동 재시도를 추가하십시오. 약 30초 후 한 번 재시도하면 전체 재시작 기간을 문제없이 넘길 수 있습니다.

현재 발생한 상황

502 Bad Gateway의 의미는 게이트웨이 계층이 요청을 수신했지만 백엔드 서비스로 전달하는 과정에서 응답을 받지 못했다는 것입니다. APIYI에서 일시적인 502 오류의 대부분은 백엔드 서비스 컨테이너가 자동으로 재시작되었기 때문입니다. 백엔드 프로세스를 잠시 사용할 수 없는 동안에는 다음과 같은 현상이 발생합니다.
  • 웹 콘솔(대시보드, 충전 페이지 등)을 불러오지 못하거나 오류가 표시됩니다.
  • API(api.apiyi.com 및 기타 모든 엔드포인트)가 502 오류를 반환합니다.
두 기능은 동일한 서비스에서 제공되므로 함께 실패하고 함께 복구됩니다. 이상이 감지되면 시스템이 자동으로 재시작을 완료하며, 전체 과정은 수동 개입 없이 대개 1분 이내에 완료됩니다.
이 유형의 502 오류는 코드, 키, 잔액 또는 네트워크 구성과 아무런 관련이 없습니다. 처음 이 오류를 확인한 경우 클라이언트 측에서 디버깅할 사항은 없습니다. 30~60초 동안 기다린 후 다시 시도하면 됩니다. 대부분의 경우 서비스는 이미 복구되어 있습니다.

수행할 작업

1

1단계: 30~60초 기다린 후 요청을 다시 전송합니다

컨테이너 재시작은 일반적으로 1분 이내에 완료됩니다. API 호출을 다시 전송하기만 하면 됩니다. 실패한 호출에는 과금되지 않으므로 재시도해도 중복으로 요금이 청구되지 않습니다.
2

2단계: 웹 콘솔이 로드되지 않으면 페이지를 강제로 새로 고칩니다

복구된 후에도 브라우저에 캐시된 오류 페이지가 계속 표시될 수 있습니다. Ctrl+Shift+R(Windows) 또는 Cmd+Shift+R(Mac)을 사용하여 강제로 새로 고치면 정상 인터페이스를 확인할 수 있습니다.
3

3단계: 502 오류가 5분 넘게 지속되면 지원팀에 문의합니다

일시적인 재시작은 몇 분 이상 지속되지 않습니다. 502 오류가 5분 넘게 지속되면 일반적인 자동 재시작이 아닙니다. 이 페이지 하단의 문의 옵션을 통해 발생한 대략적인 시간(시간대 포함, 예: 14:30 (UTC+8))을 함께 알려 주시기 바랍니다.

프로그래밍 방식 호출에 자동 재시도 추가하기

워크로드에서 가용성이 중요하다면 클라이언트 측에서 502와 같은 일시적인 오류에 대한 자동 재시도를 추가합니다. 약 30초 후 한 번 재시도하면 전체 재시작 시간을 포괄할 수 있습니다.
이 재시도 전략은 요청이 서비스에 도달하지 않은 502/503 유형의 오류에만 적용합니다. 클라이언트 타임아웃으로 중단된 요청(또는 524)은 서버 측에서 여전히 실행 중일 수 있으며 정상적으로 과금됩니다. 이러한 요청을 무조건 재시도하면 중복 과금이 발생합니다. 이 유형의 문제는 API 타임아웃을 방지하는 방법을 참조하십시오.
요청 빈도가 높은 워크로드에서는 지수 백오프(1초, 그다음 2초, 그다음 4초)를 사용하여 빠르게 확인할 수도 있습니다. 네트워크의 일시적인 문제로 발생한 502는 일반적으로 몇 초 내에 해결됩니다. 그래도 이러한 시도가 계속 실패하면 30초 간격으로 전환하여 컨테이너 재시작 상황에 대응합니다.

자주 묻는 질문

아니요. 502는 요청이 백엔드 서비스에 실제로 도달하지 않았다는 의미입니다. 모델 사용이 발생하지 않았으므로 과금 기록에 아무것도 표시되지 않습니다.이는 유용한 진단 방법이기도 합니다. 실패한 요청에 호출 로그의 과금 항목이 없다면 서버 측에서 처리되지 않은 것이므로 안전하게 다시 전송할 수 있습니다.
  • 502: 백엔드 서비스를 일시적으로 사용할 수 없습니다(컨테이너가 재시작 중입니다). 30~60초 기다린 후 다시 시도하십시오. 과금되지 않습니다.
  • 타임아웃 / 연결 끊김: 클라이언트 타임아웃이 너무 짧은 것입니다. 서버는 여전히 요청을 실행 중일 수 있으며 정상적으로 과금될 수 있습니다. API 타임아웃을 방지하는 방법을 참조하십시오.
  • 429: 동시 실행 수 또는 요청 제한에 도달한 것입니다. 서비스 가용성과는 관련이 없습니다. API 동시 실행 수 제한을 참조하십시오.
  • 524: CDN 엔드포인트(api-cf.apiyi.com)를 사용 중이며 약 100초를 초과하는 요청을 보냈습니다. 엔드포인트를 전환하십시오.
이러한 경우에는 대응 방법이 완전히 다릅니다. 502/503만 직접 다시 시도해야 합니다.
웹 콘솔과 API는 동일한 서비스에서 제공됩니다. 컨테이너가 재시작되는 동안 둘 다 동시에 사용할 수 없게 되며 동시에 복구됩니다. 따라서 “웹사이트도 다운되었습니다”라는 현상은 클라이언트 구성 문제가 아니라 일시적인 플랫폼 측 이벤트임을 정확히 확인해 줍니다.
아니요. 정기적으로 발생하는 문제는 아닙니다. 일시적인 502는 일반적으로 갑작스러운 트래픽 급증과 관련이 있으며 간헐적으로 발생합니다.2026년 8월 현재 백엔드 서버를 업그레이드하고 확장하고 있으며, 이에 따라 이러한 일시적인 502의 발생 빈도가 크게 줄어들 것입니다. 플랫폼 측 인시던트가 발생하면 실시간 상태 피드에 상태 업데이트와 복구 진행 상황을 즉시 게시합니다.
다음 두 가지를 빠르게 확인하십시오.
  1. 웹 콘솔 열기: api.apiyi.com에서 502가 반환되고 콘솔도 로드되지 않는다면, 일시적인 플랫폼 측 재시작일 가능성이 매우 높습니다. 1분 정도 기다리십시오.
  2. 네트워크 전환: 모바일 데이터(다른 통신사)를 사용하여 콘솔을 로드하거나 아래 명령을 실행해 보십시오. 다른 네트워크에서 작동한다면 문제는 로컬 네트워크 또는 프록시에 있습니다.
다른 네트워크에서도 5분 넘게 계속 502가 반환되면 지원팀에 문의하십시오.또한 웹 콘솔은 정상적으로 작동하지만 스크립트에서 빈 본문과 함께 간헐적으로 502가 발생하고 해당 요청이 호출 로그에 없다면, 502는 로컬 프록시 소프트웨어에서 발생했을 가능성이 큽니다. 스크립트에서 502가 발생하지만 호출 로그에는 아무것도 표시되지 않습니까?를 참조하십시오.

관련 문서

API 타임아웃을 방지하는 방법

타임아웃 설정, 추론 모델 지연 시간 및 524 진단

API를 사용하려면 프록시가 필요합니까?

직접 연결 참고 사항 및 네트워크 요구 사항

APIYI의 서버는 어디에 있습니까?

노드 위치, 지연 시간 테스트 및 구매 조언

서비스 가용성 및 SLA

가용성 약정 및 장애 대응

문의하기

WeCom 지원

WeCom 지원 QR 코드QR 코드를 스캔하거나 이 카드를 클릭하여 지원팀에 직접 문의하십시오지속적인 502 보고 및 인시던트 분류

이메일