request boundary / response boundary

Route Handler는 Web API 객체를 서버 계약으로 바꾼다

App Router의 Route Handler는 Request를 해석하고, 서버 작업을 실행한 뒤, Response 또는 NextResponse로 경계를 닫는다.

Request side

GET(request, { params })
URLparams와 searchParams를 분리해 읽는다.
BodyPOST/PATCH에서 한 번만 파싱한다.
Cookie/Header인증과 클라이언트 정보를 확인한다.

Server runtime

검증형식 오류를 처리 전에 반환
권한세션과 route policy 비교
작업DB, 캐시, 외부 API 호출

Response side

return Response.json(...)
JSONAPI 호출자가 해석할 본문과 상태 코드
Redirect화면 흐름을 바꿔야 할 때 사용
Headers/CookiesNextResponse로 변경 의도를 명시
GET 캐시 확인동적 값과 캐시 정책이 충돌하지 않게 한다.
본문 재사용 금지Request body는 스트림이므로 한 흐름에서만 읽는다.
응답 객체로 종료성공, 오류, 이동 모두 명시적인 Response를 반환한다.