Next.js App Router를 사용하다 보면 다음과 같은 문장을 자주 보게 된다.
- "Middleware는 Edge Runtime에서 실행된다"
여기서 자연스럽게 이런 의문이 생긴다.
👉 Edge Runtime은 정확히 무엇이고, 언제 사용해야 할까?
이 글에서는 Edge Runtime의 개념과
Node.js Runtime과의 차이를 중심으로 정리한다.
1. Edge Runtime이란?
Edge Runtime은
👉 사용자와 가까운 위치(CDN)에서 코드를 실행하는 환경이다.
실행 구조 비교
[Node.js Runtime]
사용자 → 중앙 서버 → 응답
[Edge Runtime]
사용자 → 가까운 CDN 서버 → 응답👉 요청을 더 가까운 위치에서 처리하여 네트워크 지연(Latency)을 줄이는 구조이다.
2. 왜 필요한가?
Edge Runtime의 목적은 응답 속도 개선이다.
장점
- 네트워크 지연 감소
- 초기 응답 속도 개선
- 글로벌 환경에서 일관된 성능 제공
👉 특히 요청 초기에 실행되는 로직에서 효과가 크다.
3. Next.js에서 Edge Runtime
Next.js에서는 일부 기능이 Edge Runtime에서 실행된다.
대표적인 기능
- Middleware
- Route Handler (옵션 설정 시)
- Edge API Routes
👉 Middleware는 기본적으로 Edge에서 실행된다.
4. Node.js Runtime과의 차이
두 환경은 역할이 명확히 다르다.
Node.js Runtime
- 서버 환경
- Node API 사용 가능 (
fs,net등) - DB 접근 가능
- 복잡한 로직 처리에 적합
Edge Runtime
- CDN 기반 실행 환경
- 일부 API 제한
- 빠른 실행에 최적화
- 가벼운 로직 처리에 적합
👉 "무거운 처리 vs 빠른 분기 처리" 기준으로 구분하면 이해하기 쉽다.
5. Edge Runtime의 제한
Edge Runtime은 경량 환경이기 때문에 제약이 존재한다.
사용 불가능
fs(파일 시스템)net,http- 일부 Node.js 전용 라이브러리
👉 Node.js와 동일한 서버 환경이 아니다는 점이 핵심이다.
6. Edge Runtime에서 가능한 것
fetch- 쿠키 / 헤더 처리
- 인증 로직
- 리다이렉트
- 간단한 조건 분기
👉 요청 초기에 빠르게 판단하는 로직에 최적화된 환경이다.
7. 왜 Middleware는 Edge에서 실행될까?
Middleware는 요청이 들어오자마자 실행된다.
특징
- 모든 요청에서 실행됨
- 응답 지연 최소화가 중요
- 단순한 분기 로직 중심
이 특성 때문에
👉 지연을 최소화할 수 있는 Edge Runtime이 적합하다.
8. 언제 Edge Runtime을 사용해야 할까?
적합한 경우
- 인증 체크 (로그인 여부)
- 리다이렉트 처리
- 요청 필터링
- 로깅
- A/B 테스트
👉 공통점: 빠르게 판단하고 넘기는 로직
부적합한 경우
- DB 접근
- 복잡한 비즈니스 로직
- 무거운 연산
이런 경우는 Node.js Runtime이 더 적합하다.
9. 핵심 정리
- Edge Runtime은 CDN 환경에서 실행되는 경량 실행 환경
- 빠른 응답을 위해 설계됨
- Node.js보다 기능 제한이 존재
- Middleware는 기본적으로 Edge에서 실행됨
- 빠른 분기 처리가 필요한 로직에 적합
한 줄 정리
Edge Runtime은 사용자와 가까운 위치에서 실행되는 경량 환경으로,
요청 초기에 빠른 처리가 필요한 로직에 적합하다.
마무리
Next.js는 하나의 실행 환경만 사용하는 구조가 아니다.
- Edge Runtime → 요청 초기에 빠르게 처리
- Node.js Runtime → 복잡한 서버 로직 처리
👉 실행 위치와 역할을 기준으로 구분하면 각 기능을 언제 사용해야 하는지 명확해진다.
