지니제스트 테크 블로그 배너
지니제스트Tech Archive
Cloudflare8분 소요

Cloudflare Workers 배포 후 HTTP 522 오류 원인 찾기

•
지지니제스트
•조회 2

Workers를 붙인 뒤 522 Connection timed out이 날 때, 522는 Worker 코드가 아니라 오리진 TCP 연결 실패라는 점에서 출발해 Worker의 fetch 대상, 자기 자신을 부르는 요청, 방화벽의 Cloudflare IP 차단을 차례로 확인하는 방법과 1101·1102 오류와의 구분법을 정리했습니다.

Cloudflare Workers 배포 후 HTTP 522 오류 원인 찾기

도메인에 Worker를 붙이고 배포했더니 일부 경로에서 Error 522: Connection timed out 화면이 뜨는 경우가 있습니다. Worker 코드가 느려서 생긴 문제로 보고 코드를 최적화하는 경우가 많은데, 522는 그런 오류가 아닙니다.

522는 Cloudflare가 오리진 서버와 TCP 연결을 맺지 못했다는 뜻입니다. Worker 코드 자체가 한도를 넘으면 522가 아니라 1101이나 1102 같은 다른 오류가 납니다. 이 구분부터 하면 원인을 찾는 범위가 훨씬 좁아집니다.

Workers 522 오류 원인별 확인과 조치 표
522 원인 구분

오류 번호로 먼저 구분

오류 의미
1101 Worker 코드에서 처리되지 않은 예외 발생
1102 Worker가 CPU 시간이나 메모리 한도 초과
522 오리진과 TCP 연결을 맺지 못함
524 오리진과 연결은 됐지만 응답이 너무 늦음

Cloudflare 문서 기준으로 522는 두 경우에 납니다. 오리진에 연결 요청(SYN)을 보내고 19초 안에 응답을 받지 못했을 때, 그리고 연결 후 요청에 대한 확인(ACK)을 90초 안에 받지 못했을 때입니다.

Worker가 붙은 경로라면 522가 나는 지점은 Worker 안의 fetch()입니다. Worker가 오리진이나 외부 서버로 보낸 요청이 연결에 실패한 것입니다.


Worker 로그로 실패한 요청 찾기

wrangler tail로 실시간 로그를 보면서 오류가 나는 요청을 다시 보내 봅니다.

BASH
# 오류 응답만 실시간으로 보기
npx wrangler tail my-worker --status error --format pretty

Worker 안에서 실패한 fetch의 대상 URL과 응답 코드를 로그로 남겨 두면 원인을 훨씬 빨리 찾습니다.

TYPESCRIPT
const res = await fetch(upstreamUrl, init);
if (res.status >= 520) {
  console.error("upstream error", res.status, upstreamUrl);
}

대시보드의 Workers & Pages > 해당 Worker > Logs에서도 Workers Logs를 켜 두면 지난 요청을 검색할 수 있습니다.


원인 1: Worker가 자기 자신을 부르는 경우

가장 흔하면서도 알아채기 어려운 경우입니다. example.com/*에 Worker 라우트를 걸어 둔 상태에서 Worker 안에서 fetch("https://example.com/api")를 부르면, 그 요청은 오리진이 아니라 같은 존으로 다시 들어갑니다. 설정에 따라 루프가 되거나, 존에 실제 오리진이 없어서 연결할 곳이 없으면 522가 됩니다.

Cloudflare 문서도 Workers의 522 원인으로 자기 참조 요청을 먼저 듭니다. 해결 방법은 이렇습니다.

  • 오리진을 따로 두는 구성이라면 오리진 서버를 다른 호스트명(origin.example.com)으로 노출하고 그 주소로 fetch합니다.
  • Worker가 오리진 역할까지 하는 구성이라면 Worker 안에서 같은 도메인을 fetch하지 말고 내부 함수를 직접 호출합니다.
  • 다른 Worker를 불러야 한다면 HTTP 대신 서비스 바인딩을 씁니다.
JSONC
// wrangler.jsonc: 다른 Worker를 HTTP가 아닌 바인딩으로 호출
{
  "services": [{ "binding": "API", "service": "my-api-worker" }]
}
TYPESCRIPT
// 같은 계정의 다른 Worker를 직접 호출 (공용 인터넷을 거치지 않음)
const res = await env.API.fetch(request);

원인 2: 오리진 방화벽이 Cloudflare IP를 막는 경우

Worker가 정상적으로 오리진 서버를 부르는데 522가 난다면, 오리진 쪽에서 연결을 받지 않는 것입니다. Cloudflare 문서가 꼽는 가장 흔한 원인은 오리진 방화벽이나 보안 플러그인이 Cloudflare IP를 차단하거나 속도 제한을 거는 경우입니다.

BASH
# 오리진 서버에서: Cloudflare 대역이 허용돼 있는지 확인할 목록
curl -s https://www.cloudflare.com/ips-v4
curl -s https://www.cloudflare.com/ips-v6

# 오리진 서버에서: 443 포트가 실제로 열려 있는지
sudo ss -ltnp | grep ':443'

외부 다른 네트워크에서 오리진 IP로 직접 접속해 보면 서버 자체가 살아 있는지 확인할 수 있습니다.

BASH
# DNS를 우회해 오리진 IP로 직접 연결 테스트
curl -svo /dev/null --resolve example.com:443:203.0.113.10 \
  --connect-timeout 10 https://example.com/

여기서도 연결이 안 되면 서버가 꺼져 있거나 과부하로 연결을 받지 못하는 상태입니다. 직접 연결은 되는데 Cloudflare를 거칠 때만 안 된다면 방화벽의 Cloudflare 대역 허용 여부를 확인합니다. Fail2ban 같은 도구가 많은 요청을 보내는 Cloudflare IP를 공격으로 보고 차단하는 경우도 있습니다.


원인 3: DNS 레코드가 잘못된 오리진을 가리키는 경우

예전 서버 IP가 DNS 레코드에 남아 있거나, 서버를 옮긴 뒤 레코드를 안 고친 경우입니다. 프록시(주황색 구름)가 켜진 A·AAAA·CNAME 레코드가 실제 오리진을 가리키는지 확인합니다. IPv6 주소(AAAA)만 오래된 값으로 남아 있으면 일부 요청만 실패하기도 합니다.

Worker만으로 동작하는 사이트라면 오리진이 필요 없으니 커스텀 도메인(Custom Domains) 방식으로 연결하는 편이 깔끔합니다. 라우트 방식으로 붙였다면 존에 존재하지 않는 오리진을 가리키는 더미 레코드가 남지 않았는지 봅니다.


Worker 코드 한도 문제라면

오류 번호가 522가 아니라 1102라면 그때가 Worker 코드를 볼 차례입니다. 기준은 실제 경과 시간이 아니라 CPU 시간입니다.

  • 무료 플랜: 요청당 CPU 시간 10ms
  • 유료 플랜: 기본 30초, 설정으로 최대 5분까지

fetch로 외부 응답을 기다리는 시간은 CPU 시간에 들어가지 않습니다. 클라이언트가 연결을 유지하는 동안 요청의 경과 시간 자체에는 제한이 없습니다. 그래서 큰 JSON 파싱, 이미지 처리, 암호화처럼 계산이 무거운 작업이 1102의 주된 원인입니다.

JSONC
// wrangler.jsonc: 유료 플랜에서 CPU 한도 조정
{
  "limits": { "cpu_ms": 60000 }
}

응답을 보낸 뒤 처리할 일은 ctx.waitUntil()로 넘길 수 있지만, 응답 후 최대 30초까지만 보장됩니다. 그보다 긴 작업은 Queues로 넘기는 게 맞습니다.


자주 받는 질문

Q. wrangler dev에서는 괜찮은데 배포 후에만 522가 납니다.

로컬에서는 fetch가 로컬 네트워크에서 바로 나가지만, 배포 후에는 Cloudflare 네트워크에서 나갑니다. 오리진 방화벽이 사무실 IP만 허용하고 Cloudflare 대역을 막고 있거나, 자기 도메인을 다시 부르는 구조라 배포 후에만 같은 존으로 되돌아오는 경우가 대부분입니다.

Q. 외부 API가 느려서 Worker가 오래 기다리는 건 괜찮나요?

CPU 시간을 쓰지 않으니 한도 문제는 없습니다. 다만 사용자가 그동안 기다려야 하니 타임아웃은 직접 거는 게 좋습니다. fetch(url, { signal: AbortSignal.timeout(10_000) })처럼 쓰면 10초 뒤 요청을 끊고 대체 응답을 줄 수 있습니다.

Q. 동시에 많은 fetch를 보내면 느려집니다.

Workers는 요청 하나에서 응답 헤더를 기다리는 동시 연결을 6개로 제한합니다. 7번째부터는 앞의 연결이 헤더를 받을 때까지 대기합니다. 수십 개를 한꺼번에 보내는 코드라면 묶어서 보내거나 결과를 캐시해야 합니다.


참고 자료