NEXT · SERVER ACTION

Server Action 선언 방식 비교

use server는 파일 전체를 서버 액션 모듈로 만들 수도 있고, 특정 함수 본문에서만 서버 실행을 표시할 수도 있습니다. 선언 위치에 따라 호출 범위가 달라집니다.

선언 위치

use server
파일 상단파일의 모든 export 함수를 서버 액션으로 취급합니다.
함수 내부특정 함수만 서버에서 실행되는 action으로 표시합니다.
호출 지점form action이나 클라이언트 이벤트에서 호출됩니다.
서버 실행DB 접근, 쿠키 처리 같은 서버 작업을 수행합니다.
revalidate/UI캐시 무효화나 redirect로 화면을 갱신합니다.
선언호출서버 실행무효화UI 갱신

Server Action 선언 선택 기준

경계
여러 action관련 서버 액션을 모아둘 때 파일 상단 선언이 깔끔합니다.
가까운 로직컴포넌트 주변의 단일 액션은 함수 내부 선언이 읽기 쉽습니다.
보안서버 액션이어도 입력 검증과 권한 확인은 필수입니다.
캐시데이터 변경 후 revalidatePath나 revalidateTag를 검토합니다.