server 액션 계약

서버 액션 책임 구간

폼은 호출만 담당하고, 검증과 변경은 서버에서 처리하며, 캐시 재검증으로 화면의 데이터를 다시 맞춥니다.

form

입력 수집

브라우저 표준 FormData를 사용해 필드 이름과 값을 서버 액션으로 보냅니다.

action 속성
validate

서버 검증

권한, 필수값, 스키마 검증은 신뢰할 수 있는 서버 경계에서 다시 확인합니다.

최종 방어선
mutate

데이터 변경

DB 쓰기, 외부 API 호출, 파일 처리처럼 민감한 로직은 클라이언트 번들에 넣지 않습니다.

서버 전용 코드
refresh

화면 동기화

변경 후 revalidatePath, revalidateTag, redirect로 사용자가 보는 데이터를 갱신합니다.

캐시 재검증
서버 액션 책임

서버 액션은 API 라우트를 없애는 기능이 아니라, 데이터 변경 책임을 서버 함수로 더 가깝게 옮기는 패턴입니다.