이번 룰의 목적은 서비스에서 제공하는 모든 JPG, JPEG, PNG 이미지 요청을 Cloudflare Image Transformations로 통일하고, 클라이언트 환경에 맞는 포맷과 품질로 전달하는 것이었습니다.

변환 URL의 기본 구조는 아래와 같습니다. ${1}은 Rewrite 규칙에서 캡처한 원본 이미지 경로를 의미합니다.

/cdn-cgi/image/format=auto,quality=high,onerror=redirect/${1}

최초 설계는 변환 실패 시 리다이렉트된 요청에 ?image=fail을 붙이고, 해당 요청만 원본 이미지로 통과시키는 방식이었습니다. 이 표식이 있어야 fallback 요청을 일반 이미지 요청과 구분할 수 있습니다.

기대와 달리 원본 파일이 존재하는 콘텐츠에서도 404가 다수 발생했습니다. 분석 결과, 실제 원인은 Snippet의 서브리퀘스트와 Rewrite 조건이 결합되면서 발생한 재귀 루프였습니다.

즉, 이 사례의 404는 원본 파일이 없어 발생한 오류가 아니었습니다. fallback 상태가 유실된 요청이 이미지 변환 룰에 재진입하면서 발생한 내부 요청 한도 초과가 원인이었습니다.

룰만으로는 상태 전달과 재진입 제어가 어려워 보였기 때문에 Workers 기반 이미지 변환도 검토했습니다. Workers는 URL, 요청 헤더, 변환 결과, fallback 응답을 하나의 코드 흐름에서 관리할 수 있다는 장점이 있습니다.

최종 설계의 핵심은 fallback 상태를 쿼리스트링 하나에만 의존하지 않는 것입니다. 외부 요청을 구분하는 표식과 Snippet 서브리퀘스트를 구분하는 표식을 분리했습니다.

최종 룰의 정책을 의사 코드로 표현하면

아래 코드는 실제 Cloudflare Rules 언어가 아니라, 최종 구성의 판단 조건과 실행 순서를 설명하기 위한 의사 코드입니다.

// Rewrite 1: 이미지 변환 룰
// 반드시 Rewrite 목록의 마지막에 배치한다.
if (
  query.image !== "fail" &&
  request.headers["image-optimization"] !== "remove"
) {
  rewrite(
    "/cdn-cgi/image/format=auto,quality=high,onerror=redirect" +
    request.path
  );
}

// Response Header Transform: 변환 실패 후 307 응답에만 적용
if (response.status === 307) {
  response.headers["Location"] =
    "https://a.com/bbb.jpg?image=fail";
}

// Snippet: fallback 요청을 원본 요청으로 전환
if (query.image === "fail") {
  request.headers["image-optimization"] = "remove";
  removeQueryParameter("image");
  return fetch(request);
}

운영 중 확인한 추가 규칙

• ✓ 이미지 변환 Rewrite는 상위에 두었을 때 기대대로 실행되지 않는 사례가 있었으므로, Rewrite 목록의 마지막 룰로 배치했습니다.
• ✓ Rewrite는 요청 생명 주기 동안 한 번만 실행된다고 가정하면 안 됩니다. 특히 Snippet 또는 Worker의 fetch()는 새로운 내부 요청 경로를 만들 수 있습니다.
• ✓ fallback 요청을 식별하는 URL 표식과 내부 처리 단계를 식별하는 헤더 표식은 서로 다른 역할으로 분리하는 것이 안전합니다.

문제 해결 후에는 “404가 사라졌는가”만 확인해서는 부족합니다. 정상 변환, fallback, 실제 원본 누락, 서브리퀘스트 재진입까지 각각 분리해 검증해야 합니다.

이번 장애에서 원본 이미지 URL은 정상적이었습니다. 하지만 Edge에서 동작하는 여러 기능이 Rewrite → Snippet → subrequest → Rewrite 순서로 연결되면서, fallback 상태가 사라진 요청이 이미지 변환 룰에 재진입했습니다.

결국 해결의 핵심은 변환 기능을 바꾸는 것이 아니라, 요청이 어느 단계에 있는지 식별할 수 있는 상태를 명확하게 전달하는 것이었습니다. URL 쿼리는 외부 fallback 상태를, 요청 헤더는 내부 서브리퀘스트 상태를 맡게 했고, 이미지 변환 Rewrite를 마지막 룰로 배치해 재진입을 차단했습니다.

이미지 최적화는 겉으로 보기에는 단순한 URL 변환처럼 보이지만, fallback과 서브리퀘스트가 더해지는 순간 요청 흐름 자체를 설계해야 하는 문제로 바뀝니다. 정상 URL이 404가 되는 상황을 막기 위해서는, 규칙 하나보다 전체 Edge 요청 생명 주기를 먼저 그려보는 것이 중요합니다.

1. Cloudflare Developers, Transform via URL — onerror=redirect의 동작과 적용 제약을 확인할 수 있습니다. 공식 문서의 내용은 라이선스 준수를 위해 요약·재서술했습니다.