블로그로 돌아가기
2026년 11월 17일Sergei Solod15 분 읽기

정적 Next.js 사이트의 높은 nginx CPU 사용률: 정규식 리디렉션 수정

정적 Next.js 사이트에서 nginx의 정규식 리디렉션 맵이 CPU 시간을 과도하게 소모하고 있었다. 정확히 일치하는 키 조회, 실제 HTTP 응답의 동등성 검증, 통제된 벤치마크를 통해 기존 페이지와 미디어 URL을 유지하면서 CPU 작업량을 크게 줄인 과정을 다룬다.

Nginx성능PCRE리디렉션Next.js

프런트엔드는 이미 정적 HTML로 빌드되어 있었다. nginx가 생성된 페이지와 미디어 파일을 직접 제공했지만, 워커 프로세스는 평범한 요청을 처리하는 데도 예상보다 훨씬 많은 CPU 시간을 쓰고 있었다. 요청마다 실행되는 Next.js 렌더링은 없었으므로 이를 최적화할 수도 없었다. 비용이 큰 작업은 그보다 앞에서 일어났다. nginx가 요청된 URL이 계속 늘어나는 과거 리디렉션 규칙 중 하나에 해당하는지 판단하고 있었던 것이다.

최종 수정에서는 기존 링크를 그대로 사용할 수 있게 했다. 페이지 리디렉션, 번호가 붙은 이미지의 이전 URL, 동영상의 이전 URL은 유지하면서 수천 번의 정규식 비교를 소수의 경로 구조 검사와 해시 테이블 조회로 바꿨다. 변경 사항을 배포한 뒤 기존 라우팅 동작과 비교해 검증했다. 조건을 통제해 반복한 벤치마크에서는 테스트에 사용한 요청 구성에서 HTTP 응답을 바꾸지 않고 nginx 워커의 CPU 시간이 100분의 1 미만으로 줄었다.

정적으로 내보낸 Next.js 사이트에서도 CPU가 병목이 된 이유

정적 내보내기를 사용하면 페이지 렌더링이 요청 처리 경로에서 빠지지만, nginx의 라우팅 로직까지 사라지는 것은 아니다. HTML 페이지나 이미지를 제공하기 전에 nginx는 경로 정규화, 리디렉션 맵 평가, location 선택, 파일 존재 여부 확인, 응답 생성 등의 작업을 수행할 수 있다. 파일 시스템이 아무리 빨라도 요청마다 비용이 큰 URL 매칭을 반복하면 그 부담을 상쇄할 수 없다.

설정에는 서로 다른 종류의 과거 규칙이 쌓여 있었다. 이전 페이지에 대한 정확히 일치하는 별칭은 새로운 정규 경로를 가리켰다. 폐기된 페이지네이션 경로도 리디렉션했는데, 여기에는 공통된 경로 구조가 있었다. 별도로 이름이 바뀐 미디어 경로에는 선택적으로 붙는 이미지 번호를 캡처하는 정규식이 쓰였고, 동영상 파일 이름에도 자체 별칭 규칙이 있었다. 문제는 리디렉션이 존재한다는 사실이 아니라, 구조가 비슷한 수많은 리디렉션을 각각 독립된 정규식으로 정의해 둔 데 있었다.

먼저 비슷한 CPU 증상을 일으키는 다른 원인부터 배제하기

사이트는 가상화된 Linux에서 실행되고 있었기 때문에 하이퍼바이저의 CPU steal도 처음에는 의심할 만한 원인이었다. 높은 로드 애버리지만 보고 결론을 내리지 않고 CPU 사용률, steal 시간, 프로세스별 CPU 소비량, 메모리 압박, 디스크 대기 시간을 비교했다. 기본적으로 사용한 명령은 다음과 같다.

mpstat -P ALL 1 5
pidstat -u -C nginx 1 5
vmstat -w 1 6

MASTER=$(systemctl show nginx -p MainPID --value)
WORKERS=$(pgrep -P "$MASTER" -d,)
perf record -F 49 -g -p "$WORKERS" -- sleep 10
perf report --stdio --no-children -g none

핵심 관찰 결과는 CPU steal은 비교적 적은 반면 nginx 워커가 사용자 공간에서 상당한 CPU를 소비하고 있다는 것이었다. 측정값은 지속적인 디스크 대기나 실제 스와핑이 주원인이라는 설명을 뒷받침하지 않았다. 프로세스별 정보로 어떤 프로그램이 바쁜지 알 수 있었고, perf로 그 프로그램이 무슨 작업을 하는지 파악할 수 있었다.

한 번의 샘플에서는 관측된 CPU 활동의 약 3분의 1이 pcre_exec에 해당했고, ngx_http_regex_exec와 ngx_regex_exec에서도 추가 시간이 소비됐다. 이 함수들은 nginx가 PCRE를 통해 정규식을 실행할 때 나타나는 함수들이다. 프로파일만으로 어떤 개별 리디렉션 맵이 문제인지 입증할 수는 없었다. 하지만 정적 HTML 렌더링 문제보다는 정규식 평가가 반복되고 있다는 설명에 훨씬 더 무게가 실렸다.

nginx map에 순서대로 나열된 정규식의 숨은 비용

nginx의 map 자체가 느린 것은 아니다. 문자열 리터럴 키는 효율적으로 찾을 수 있지만, 정규식 항목은 우선순위가 더 높은 매칭 방식이 처리된 다음 설정된 순서대로 검사된다. 맵 변수는 참조될 때 평가되므로, 자주 실행되는 요청 경로에서 결과를 사용한다면 정규식 항목이 많은 맵이 부담이 된다. 과거 별칭과 전혀 일치하지 않는 현재의 정규 이미지조차 nginx가 파일 내용을 전달하기 전에 수많은 실패한 매칭을 거칠 수 있다.

이 차이 때문에 location ~ 블록 수만 세는 것도 잘못된 판단으로 이어질 수 있다. 정규식 기반 location 선택과 map 내부의 정규식 평가는 서로 다른 메커니즘이다. 프로파일링으로 어떤 종류의 작업에 비용이 드는지 알아낸 다음, 요청 처리 경로와 변수를 참조하는 지점을 확인해야 실제 실행 위치를 찾을 수 있다.

원인을 더 분리해 보니 미디어 목록만 문제가 아니었다. 별도의 페이지네이션 리디렉션 규칙 집합도 해당 맵이 평가될 때 상당한 정규식 처리 비용을 발생시켰다. 이미지만 최적화했다면 이 독립적인 비용은 그대로 남았을 것이다.

페이지 리디렉션: 페이지네이션 패턴은 하나지만 목적지는 수천 개

페이지 규칙은 반복적인 형태였다. 경로마다 예전 식별자는 달랐지만 끝부분은 /topics/old-a/page/99처럼 공통된 페이지네이션 패턴을 따랐다. 99를 추출해 새 슬러그에 붙이면 될 것 같지만, 그렇게 하면 틀린다. 과거의 일부 페이지네이션 규칙은 요청한 페이지가 3이든 99이든 모든 페이지 번호를 /topics/current-a/page/7 같은 고정된 마지막 페이지로 보내도록 의도적으로 설정되어 있었기 때문이다.

또 하나 중요한 제약이 있었다. nginx에서는 map의 정확히 일치하는 키가 정규식보다 우선한다. 일부 정확 일치 항목은 일반적인 페이지네이션 규칙이 만들 결과를 덮어썼다. 이미 정규 경로인 URL을 리디렉션하지 않도록 값을 명시적으로 빈 문자열로 설정한 항목도 있었다. 목적지가 비어 있는지만 검사하면 정확히 일치하는 항목이 없음과 정확히 일치하는 항목은 있지만 값이 비어 있음을 구별하지 못한다.

대체 방식에서는 경로 인식과 목적지 선택을 분리했다. 다음은 nginx의 http 컨텍스트에 정의하는 맵을 단순화한 가상 예시다.

# http context: synthetic page aliases
map $uri $normalized_path {
    default $uri;
    ~^(.+)/$ $1;
}

map $normalized_path $exact_target {
    default "__NO_EXACT__";
    /topics/old-a        /topics/current-a;
    /topics/old-a/page/2 /topics/current-a/page/2;
    /topics/old-b/page/2 "";
}

map $normalized_path $pagination_key {
    default "";
    ~^/(?<old_root>topics/[a-z0-9-]+)/page/[1-9][0-9]*$ /$old_root;
}

map $pagination_key $pagination_target {
    default "";
    /topics/old-a /topics/current-a/page/7;
    /topics/old-b /topics/current-b/page/6;
}

map $exact_target $redirect_target {
    default $exact_target;
    __NO_EXACT__ $pagination_target;
}

첫 번째 맵은 끝 슬래시 정규화를 유지한다. 두 번째 맵에는 정확히 일치하는 리디렉션과 명시적인 빈 문자열 예외를 저장하고, 일치하는 항목이 없다는 사실은 센티널 값으로 표시한다. 세 번째 맵은 정규식 하나로 페이지네이션의 루트 경로를 추출한다. 네 번째 맵은 그 루트를 정확 일치 키로 조회해 기존 규칙에 정의된 고정 목적지를 찾는다. 마지막 선택 단계에서는 빈 문자열 예외까지 포함해 정확히 일치한 결과가 있으면 이를 페이지네이션 결과보다 우선한다.

리디렉션을 수행하는 서버는 최종 $redirect_target이 비어 있지 않을 때만 그 값을 사용할 수 있다. 이때 원래의 HTTP 상태 코드를 유지하고, 기존 정책이 쿼리 문자열을 보존하는 경우 $is_args$args를 덧붙인다. 센티널 값이 실제 목적지와 충돌하지 않도록 예약하고 검증해야 한다. 예시에는 설명을 위한 중립적인 경로를 사용했지만, 실제 운영용 생성기는 전체 매핑 목록과 기존 우선순위를 그대로 보존해야 했다.

이 구조에서는 대소문자 처리도 놓치기 쉽다. nginx의 map은 문자열 리터럴 키를 대소문자 구분 없이 비교하지만, ~로 작성한 정규식은 대소문자를 구분한다. 따라서 모든 URL을 무심코 소문자로 바꾸거나 ~ 규칙을 ~*로 바꾼 뒤 동등한 동작이라고 주장해서는 안 된다. 원래의 매칭 의미를 재현해야 한다.

이미지와 동영상 리디렉션: 한 번 파싱하고 이전 키 조회하기

미디어 규칙에도 비슷하게 활용할 수 있는 구조가 있었다. 과거 이미지 경로는 디렉터리와 파일 이름 양쪽에 갤러리 식별자를 포함하고, 끝에 번호가 선택적으로 붙는 형태였다. 예를 들면 /old-gallery/old-gallery-17.avif다. 목적지에서는 이 번호를 그대로 쓰되 디렉터리와 파일 이름의 접두부를 바꿨다. 이전 갤러리마다, 번호 형태마다 정규식을 따로 생성하면 같은 문법을 공유하는 경로를 불필요하게 반복 비교하게 된다.

더 효율적인 map은 정규식 하나로 식별자와 선택적인 번호 접미부를 추출한 뒤, 문자열 리터럴 키 조회로 새 접두부를 찾는다.

# http context: synthetic AVIF rename inventory
map $uri $legacy_image_key {
    default "";
    ~^/(?<old_id>[a-z0-9-]+)/\k<old_id>(?<image_number>-[0-9]+)?\.avif$ $old_id;
}

map $legacy_image_key $new_image_prefix {
    default "";
    old-gallery /new-gallery/new-gallery;
    old-set     /new-set/new-set;
}

# A recognized alias now has a target candidate:
# $new_image_prefix$image_number.avif
# Existing-file checks and the actual 301 remain
# in the site's media-serving configuration.

인식된 별칭 /old-gallery/old-gallery-17.avif에서는 목적지 후보인 /new-gallery/new-gallery-17.avif를 얻는다. 이는 조회 메커니즘이지, 파일 제공 정책 전체를 나타내는 것은 아니다. 실제 배포에서는 기존 파일 우선 처리, 목적지 파일 존재 여부 확인, 301 반환 여부 결정이 계속 미디어 제공 설정에 남아 있었다. 목적지 파일이 없는데도 단순화한 예시처럼 무조건 301을 반환했다면 원래 동작을 잘못 대체했을 것이다.

동영상 리디렉션에서도 파일 이름 형태를 판단하는 정규식 하나 뒤에 유사한 정확 일치 키 테이블을 두었다. 과거 별칭 조회를 이미지 매핑에 맞게 정규화하던 기존 WebP 호환 경로도 그대로 유지해야 했다. 미디어 최적화가 성공했다고 말하려면 현재 파일이 여전히 올바른 바이트 데이터와 헤더를 반환해야 하고, 이전 동영상 별칭을 따라간 경우에도 범위 요청에 대해 206 Partial Content를 지원해야 한다.

이 예시들이 가능한 것은 과거 매핑 목록의 파일 이름이 예측 가능한 문법을 따랐기 때문이다. 파일마다 아무런 공통 규칙 없이 이름이 따로 바뀌었다면 파일별 정확 일치 키, 생성된 인덱스 또는 조회 범위가 제한된 다른 방법을 쓰는 편이 안전하다. 공통 패턴도 없는 목적지를 정규식 하나로 복원할 수 있다고 가정해서는 안 된다.

별도로 존재하던 410 맵은 어떻게 처리했나

설정의 다른 부분에는 폐기된 페이지 패턴을 명시적으로 나열해 오직 410 Gone을 반환하기 위한 맵이 있었다. 기존 정적 파일 라우팅 정책이 실제로 존재하지 않는 페이지에 이미 410을 반환한다는 것을 확인한 뒤 이 전용 맵을 제거했다. 과거 페이지 폐기 관련 메타데이터는 검증할 수 있도록 남겨 두고, 요청 시점의 중복된 매칭만 없앴다.

이것은 해당 설정에서만 가능한 판단이지 nginx의 기본 동작이 아니다. 별도 설정이 없는 try_files는 대개 404로 끝난다. 명시적인 410 규칙을 제거해도 안전하려면, 실제 서버에서 없는 리소스를 처리하는 경로가 폐기된 페이지네이션 URL과 내부 오류 페이지 처리까지 포함해 필요한 410을 계속 반환해야 한다. 변경을 받아들이기 전에 실제 HTTP 요청으로 이 조건을 확인했다.

더 빠른 리디렉션 맵이 이전과 똑같이 동작하는지 입증하는 방법

nginx 설정이 문법적으로 유효하더라도 과거 링크 수천 개가 아무런 경고 없이 깨질 수 있다. 따라서 새 방식의 정확성을 검사할 때는 최적화된 결과에서 목적지를 다시 만들어 낸 목록이 아니라, 원본 규칙 목록을 독립적인 검증 입력으로 사용했다. 생성된 조회 테이블에서 중복 키, 지원하지 않는 표현식, 일관되지 않은 이미지 접두부, 오래된 생성 파일이 남아 있는지를 확인했다. 안전하게 표현할 수 없는 규칙이 있다면 조용히 누락하는 대신 생성 단계에서 오류가 나도록 해야 했다.

테스트 요청 집합에는 페이지의 정확 일치 별칭, 정규 경로에 대한 빈 문자열 예외, 겹치는 페이지네이션 규칙, 고정된 페이지네이션 상한, 유효하거나 유효하지 않은 페이지 번호, 끝 슬래시, 대소문자 변형, 쿼리 문자열을 포함했다. 미디어에 대해서는 기본 이미지와 번호가 붙은 이미지, 앞에 0이 붙은 접미부, 숫자로 끝나는 식별자, 중첩된 목적지 경로, WebP 호환성, 기존 동영상 별칭을 검사했다. 파일 제공 동작이 중요한 경우에는 실제로 읽을 수 있는 테스트 파일을 사용해 응답 본문, 리디렉션, 캐시 관련 헤더, 동영상의 바이트 범위를 비교했다.

특히 중요한 점은 JavaScript에서 문자열만 비교한 것이 아니라 실제 nginx를 통한 HTTP 검사였다는 것이다. 생성한 요청 집합으로 새 설정을 시험했고, 별도의 요청 집합을 원래의 PCRE 기반 설정에 대해서도 검사했다. 보고된 결과에서 의도하지 않은 응답 차이는 0건이었다. 이후 운영 환경에서 실시한 기본 동작 점검에서도 최적화된 include 설정이 활성화되어 있고, 이전의 긴 정규식 테이블은 사용되지 않는다는 것을 확인했다.

트래픽 변화와 구분해 개선 효과를 측정한 통제 벤치마크

배포 후 운영 환경의 CPU 그래프는 크게 개선됐지만, 요청량과 요청 구성도 함께 달라졌다. 요청이 많았던 시점의 측정값을 나중의 한산한 시점과 단순 비교하면 설정 변경의 효과를 과장하게 된다.

조회 비용만 따로 측정하기 위해 동일한 nginx 바이너리로 독립적인 벤치마크를 수행했다. 기존 설정과 최적화된 설정에 같은 혼합 요청 시퀀스를 반복해서 보냈다. 이 시퀀스에는 정규 페이지, 과거 페이지 별칭, 페이지네이션 별칭, 존재하지 않는 페이지, 정규 이미지, 과거 이미지 및 동영상 별칭, 존재하지 않는 미디어가 포함됐다. 실행 순서는 구형, 신형, 신형, 구형으로 엇갈리게 구성했고, 응답 상태와 Location 값이 일치하는지도 확인했다.

이렇게 통제한 작업 부하에서 최적화된 맵의 nginx 워커 CPU 시간은 정규식을 많이 사용하는 원래 맵의 100분의 1 미만이었고, 반복 실행에서도 결과가 재현됐다. 이는 해당 요청 구성에서 리디렉션 처리 방식 변경의 효과를 강하게 뒷받침하는 측정 결과다. 운영 환경의 모든 요청이 100배 빨라졌다거나, 어떤 트래픽에서도 서버 전체의 CPU 사용량이 같은 비율로 줄어든다는 주장은 아니다.

이후 시스템 점검에서는 nginx의 CPU 사용량이 적었고 디스크 부하도 낮았으며 프로세서 유휴 시간도 충분했다. 이전에 두드러지던 PCRE 병목은 변경 후 확보한 샘플에서 더 이상 지배적이지 않았다. 다만 사용률이 매우 낮아 샘플도 적었으므로 함수별 비율을 지나치게 해석해서는 안 된다. 이 수정의 근거로는 통제된 비교, 응답 동등성 검증, 성공적인 배포가 더 강하다.

대규모 nginx 리디렉션을 더 안전하게 이전하는 절차

과거 URL이 많은 다른 사이트에서 같은 작업을 한다면, 가능한 한 기계적인 방식으로 이전하겠다. 원본 규칙 목록을 보존하고, 경로에 공통으로 나타나는 소수의 문법을 찾아 각 문법을 범위가 제한된 정규식으로 구성한 다음 목적지는 문자열 리터럴 키를 사용하는 맵에 저장하는 것이다. 정규 경로에 대한 정확 일치 예외, HTTP 상태 코드, 기존 파일 확인, 쿼리 문자열, 호스트 정규화, 대소문자 구분은 우연한 구현 세부사항이 아니라 외부에 드러나는 동작으로 취급해야 한다.

이어서 nginx -t로 생성된 전체 설정을 검사하고, 실제 nginx를 통해 이전 설정과 새 설정의 응답을 비교하고, 동일한 요청으로 벤치마크한 뒤 복원 가능한 백업과 리로드 후 검증 절차를 갖춰 배포한다. 구조 기반 방식으로 나타낼 수 없는 리디렉션이라면 조용히 삭제하지 말고 적용 범위를 좁힌 예외로 남기거나 URL별 정확 일치 항목을 사용한다.

진단의 관점을 바꿔 준 것은 정적 파일을 제공하는 것과 라우팅 비용이 낮은 것은 별개의 속성이라는 사실을 깨달은 점이다. Next.js는 이미 렌더링을 마쳤고 nginx도 파일 자체는 효율적으로 제공할 수 있었다. 최적화가 빠져 있던 부분은 파일을 제공하기 전에 수행하는 조회였다. 기존 링크를 유지하면서 이 조회를 빠르게 만드는 것은 충분히 가능했다.

정확한 우선순위와 평가 규칙은 nginx 공식 문서의 map 모듈 및 HTTP 코어 모듈의 location 선택 규칙을 참고하면 된다.