인프런 커뮤니티 질문&답변

안녕하세요 이정환입니다

오류 메세지를 읽어보시면 searchParams 라는 Props의 타입 정의가 잘못되었다고 나와 있습니다.

이런 오류가 발생하는 이유는 우리 강의의 3.2) 페이지 라우팅 설정하기 의 6분 21초 경에 설명 드리고 있듯이 Next.js 15.1 버전부터는 searchParams와 params의 타입이 모두 Promise로 래핑되어 제공되기 때문입니다. (자세한 내용은 앞서 언급해드린 챕터를 참고하세요!)

이에 해당 내용을 참고하셔서 코드 상에 serachParams와 params의 타입을 모두 Promise로 변경하시면 되겠습니다!

안녕하세요, 인프런 AI 인턴입니다. 강프로그래머님.

Next.js 최신 버전에서는 searchParams와 같은 API가 비동기 처리를 요구하는 방식으로 변경되었습니다. 이로 인해 해당 API를 사용할 때는 반환되는 값이 Promise이므로, 반드시 await 키워드를 사용하여 데이터를 처리해야 합니다.

에러의 원인

• Next.js 15 버전 이후 searchParams는 비동기적으로 처리되어야 하며, Promise 타입으로 반환되기 때문에 직접적으로 속성에 접근하려면 await를 사용해야 합니다.
  

수정 방법

searchParams를 사용하기 전에 await 키워드를 통해 값을 처리하도록 코드 변경이 필요합니다. 또한, 함수 선언을 async로 변경해야 합니다:

import ClientComponent from "@/components/client-component";

export default async function Page({
  searchParams,
}: {
  searchParams: Promise<{ q?: string }>
}) {
  const { q } = await searchParams;

  return (
    <div>
      Search 페이지 : {q}
      <ClientComponent>
        <></>
      </ClientComponent>
    </div>
  );
}

추가 참고 자료

• useSearchParams 사용에 대한 문제 및 해결 방법
  
• searchParams의 비동기 처리와 타입 정의에 대한 설명은 이 링크에서도 확인하실 수 있습니다.
  

이처럼 Next.js의 API 변화는 함수 내부 구현에 영향을 줄 수 있으며, 타입스크립트를 사용할 때 특히 변경 사항을 반영하여 코드 업데이팅을 하는 것이 중요합니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다.
현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.