Error: Route "/search" used `searchParams.q`. `searchParams` should be awaited before using its properties.
안녕하세요 강사님
해당 오류는 최신버전에서 발생하는건가요?!
Error: Route "/search" used searchParams.q. searchParams should be awaited before using its properties. Learn more: https://nextjs.org/docs/messages/sync-dynamic-apis
at Page (src/app/(with-searchbar)/search/page.tsx:12:32)
10 | return (
11 | <div>
> 12 | Search 페이지 : {searchParams.q}
| ^
13 | <ClientComponent>
14 | <></>
15 | </ClientComponent>
import ClientComponent from "@/components/client-component";
export default function Page({
searchParams,
}: {
searchParams: {
q?: string;
}
}) {
return (
<div>
Search 페이지 : {searchParams.q}
<ClientComponent>
<></>
</ClientComponent>
</div>
)
}
답변 2
0
안녕하세요 이정환입니다
오류 메세지를 읽어보시면 searchParams 라는 Props의 타입 정의가 잘못되었다고 나와 있습니다.
이런 오류가 발생하는 이유는 우리 강의의 3.2) 페이지 라우팅 설정하기 의 6분 21초 경에 설명 드리고 있듯이 Next.js 15.1 버전부터는 searchParams와 params의 타입이 모두 Promise로 래핑되어 제공되기 때문입니다. (자세한 내용은 앞서 언급해드린 챕터를 참고하세요!)
이에 해당 내용을 참고하셔서 코드 상에 serachParams와 params의 타입을 모두 Promise로 변경하시면 되겠습니다!
0
안녕하세요, 인프런 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 변화는 함수 내부 구현에 영향을 줄 수 있으며, 타입스크립트를 사용할 때 특히 변경 사항을 반영하여 코드 업데이팅을 하는 것이 중요합니다.
저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다.
현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.
풀라우트캐시 동작 원리에서 데이터 캐시 관련 질문
0
23
2
next.js 프로젝트
0
28
1
Next.js + Tanstack Query BFF 구조 질문
0
29
2
Next.js 사전렌더링 이해하기 부분
0
34
2
모달 관련 질문
0
42
3
렌더링 관련 질문
0
80
2
중복으로 하나의 api를 요청할 때 캐싱 옵션 통일화
0
64
2
라우트 세그먼트 옵션 강좌 노트에 사소한 제보 남깁니다.
0
65
2
SSR시 context에 params말고 query를 사용하면 안되나요?
0
75
2
npx prisma db push 시 에러가 뜹니다.
0
94
3
vercel 배포를 실패하였습니다.
0
101
3
Image 컴포넌트 사용시 브라우저 콘솔에 경고는 왜 뜨는걸까요?
0
57
2
getServerSideProps 함수와 SSR의 관계
0
78
6
없는 페이지인데 풀라우트캐시로 저장이 되는 이유가 궁금합니다
0
61
2
실제 프로젝트에서 SSR 사용에 관해서 질문드립니다.
0
117
2
일반적인 nextjs project architecture에 대하여..
0
90
2
2.14 Search에서 작성한건 static이긴하지만 CSR이 아닌가요?
0
74
2
배포 시 오류 발생
0
90
2
백엔드 서버 오류납니다.
0
83
2
취약점 제거시 nestjs 버전 문제가 생길까요?
0
93
1
eslint.config.mjs 내 rules 어떻게 설정 하나요?
0
107
1
[book]/[id]/page.tsx 모달 띄울 때 성능 하락 현상은 ReviewList를 불러오면서 발생하는 문제 같습니다.
0
63
2
빨간줄 설정
0
77
2
익스텐션 질문
0
61
1