serverless placement

실행 위치 결정 기준

API Routes, Server Actions, Edge Functions는 같은 서버 코드처럼 보여도 런타임 제약과 캐시 갱신 책임이 다릅니다.

Route Handler

외부 API와 DB 접근

Node SDK, 인증 토큰, 데이터 검증이 필요한 요청은 서버 함수에서 처리하고 응답 형태를 명확히 고정합니다.

입력 검증과 오류 응답을 함께 설계
Server Action

폼 제출과 데이터 변경

UI 이벤트가 서버 변경으로 이어질 때 사용하고, 성공 뒤 revalidatePath 또는 태그 갱신을 붙입니다.

변경 후 화면 갱신까지 한 흐름
Edge Runtime

요청 초입의 빠른 분기

지역, 인증 게이트, 리다이렉트처럼 가벼운 판단은 엣지에 두고 Node 전용 모듈 의존은 피합니다.

낮은 지연 시간과 제한 API의 교환
운영 메모

상태는 함수 안에 두지 말고 데이터베이스, 캐시, 세션 저장소로 밀어내야 스케일 아웃과 콜드 스타트에 흔들리지 않습니다.