작성
·
8
0
프로젝트가 계속 컴파일 실패로 뜹니다.
2025-09-04T13:19:18.380Z Failed to compile.
2025-09-04T13:19:18.381Z
2025-09-04T13:19:18.381Z src/app/book/[id]/page.tsx
2025-09-04T13:19:18.381Z Type error: Type '{ params: { id: string; } | Promise<{ id: string; }>; }' does not satisfy the constraint 'PageProps'.
2025-09-04T13:19:18.381Z Types of property 'params' are incompatible.
2025-09-04T13:19:18.382Z Type '{ id: string; } | Promise<{ id: string; }>' is not assignable to type 'Promise<any> | undefined'.
2025-09-04T13:19:18.382Z Type '{ id: string; }' is missing the following properties from type 'Promise<any>': then, catch, finally, [Symbol.toStringTag]
2025-09-04T13:19:18.382Z
2025-09-04T13:19:18.396Z Next.js build worker exited with code: 1 and signal: null
2025-09-04T13:19:18.416Z Error: Command "npm run build" exited with 1
왜 그럴까요?
답변 2
0
안녕하세요 진진님 이정환입니다.
오류 메세지를 읽어보시면params 라는 Props의 타입 정의가 잘못되었다고 나와 있습니다.
이런 오류가 발생하는 이유는 우리 강의의 3.2) 페이지 라우팅 설정하기 의 6분 21초 경에 설명 드리고 있듯이 Next.js 15.1 버전부터는 searchParams와 params의 타입이 모두 Promise로 래핑되어 제공되기 때문입니다. (자세한 내용은 앞서 언급해드린 챕터를 참고하세요!)
이에 해당 내용을 참고하셔서 코드 상에 serachParams와 params의 타입을 모두 Promise로 변경하시면 되겠습니다!
0
안녕하세요, 인프런 AI 인턴입니다. 진진님.
현재 발생하고 있는 컴파일 오류는 Next.js 프로젝트에서 params
의 타입 호환성 문제로 인해 발생한 것입니다. 오류 메시지를 살펴보면, params
속성이 컴포넌트에 주입될 때 타입 불일치가 발생하는 것으로 보입니다.
Promise 타입 이슈:
Promise
타입을 포함하고 있는데, 조건에 따라 단순 객체 형태로 제공되는 경우가 있어 문제가 발생할 수 있습니다.Next.js의 타입 처리 방식 변경:
getStaticProps
와 getServerSideProps
를 통한 params가 Promise
로 반환되어야 하고, 이에 맞춰 타입이 정의되어야 합니다.getStaticProps
나 getServerSideProps
사용 시, params
의 타입을 Promise
로 감싸서 반환해야 합니다. 예시로는 아래와 같습니다:export const getStaticProps: GetStaticProps = async (context) => {
const { params } = context;
// … 로직 수행
return {
props: { … },
};
};
“
- 속성
params에 대해 타입 정의를
Promise` 형식으로 변경하여 해결할 수 있습니다.
타입스크립트에서 명확한 타입 지정:
params: Promise<{ id: string }>
으로 타입을 분명히 지정하고, 이를 비동기 처리에서 해제(a wait)를 통해 사용해야 할 수 있습니다.Next.js 공식 문서 참조:
유사한 문제에 대한 기존 답변도 도움이 될 수 있습니다:
- checkFields, ‘default’>>() 에러?
저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.