Failed to find Server Action

오류 의미

Failed to find Server Action은 Server Action ID가 예상된 형식이지만 현재 빌드에서 일치하는 Server Action을 찾지 못했다는 뜻입니다.

클라이언트와 서버가 서로 다른 빌드를 사용하면 이 메시지가 나타날 수 있습니다. 예를 들어 브라우저가 이전 배포의 자산을 사용하고 있고, 현재 배포에는 해당 자산이 참조하는 Server Action이 없을 수 있습니다.

확인할 내용

• 클라이언트 자산과 Server Action이 같은 배포에서 제공되는지 확인합니다.
• 클라이언트와 서버가 호환되는 Next.js 버전을 사용하는지 확인합니다.
• 여러 서버에 자체 호스팅하는 경우 모든 서버 인스턴스가 같은 빌드 산출물과 암호화 키를 사용하는지 확인합니다.
• 자체 호스팅에서 NEXT_SERVER_ACTIONS_ENCRYPTION_KEY를 사용하는 경우 빌드 시 설정했는지, Base64 인코딩 값인지, AES 키 길이가 16·24·32바이트 중 하나인지 확인합니다.

원문이 제시한 처리 방법

• 클라이언트 자산과 Server Action이 같은 배포에서 제공되고 호환되는 Next.js 버전을 사용하도록 배포 구성을 맞춥니다.
• 여러 서버에 자체 호스팅하는 경우 모든 서버 인스턴스에서 같은 빌드 산출물과 암호화 키를 사용합니다.
• Vercel에 배포하는 경우 Skew Protection을 사용할 수 있습니다.

환경 변수나 배포 설정을 변경하기 전에는 현재 값과 대상 기록을 보관하고, 가능한 경우 백업 또는 내보내기를 수행합니다. 한 번에 한 항목만 변경하며, 오류가 발생하면 기록한 이전 값으로 복구합니다.