server action
폼 제출을 서버 함수 실행으로 연결한다
API route를 직접 만들지 않아도 mutation, 재검증, redirect를 서버 경계 안에서 처리할 수 있습니다.
호출 표면
form action 또는 client event에서 서버 액션을 호출한다.
실행 위치
데이터 변경과 민감 로직은 서버 함수 안에서 실행된다.
후속 처리
반환, 캐시 재검증, redirect로 UI 상태를 갱신한다.
01
Submit
사용자가 form을 제출하거나 버튼 이벤트를 발생시킨다.
02
Request
Next가 서버 액션 호출을 네트워크 요청으로 변환한다.
03
Execute
서버에서 DB 변경, 검증, 권한 확인을 수행한다.
04
Revalidate
변경된 데이터와 관련된 캐시나 경로를 갱신한다.
05
Update UI
반환 값, redirect, 새 서버 결과로 화면을 이어간다.
비교 축 API Route 방식 Server Action 방식
호출 코드 fetch, endpoint, response parsing을 직접 작성한다. 서버 함수를 form action이나 handler에 연결한다.
보안 경계 endpoint 입력 검증과 권한 처리를 별도로 설계한다. 서버 함수 내부에서 민감 로직과 검증을 묶는다.
화면 갱신 클라이언트에서 refetch와 상태 변경을 직접 조율한다. revalidate, redirect, 반환 값으로 후속 흐름을 이어간다.
mutation 중심
데이터 변경 로직은 서버 액션 안에 모은다.
캐시 연결
변경 후 stale 화면이 남지 않도록 재검증 기준을 둔다.
결과 표면
성공, 실패, redirect가 사용자 흐름에서 끊기지 않게 한다.