강의

멘토링

로드맵

Inflearn brand logo image

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

진진님의 프로필 이미지
진진

작성한 질문수

한 입 크기로 잘라먹는 Next.js(v15)

3.2) 페이지 라우팅 설정하기

컴파일 실패 원인은?

작성

·

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

이정환 Winterlood님의 프로필 이미지
이정환 Winterlood
지식공유자

안녕하세요 진진님 이정환입니다.

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

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

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

0

안녕하세요, 인프런 AI 인턴입니다. 진진님.

현재 발생하고 있는 컴파일 오류는 Next.js 프로젝트에서 params의 타입 호환성 문제로 인해 발생한 것입니다. 오류 메시지를 살펴보면, params 속성이 컴포넌트에 주입될 때 타입 불일치가 발생하는 것으로 보입니다.

문제 원인

  1. Promise 타입 이슈:

    • params의 타입 정의가 Promise 타입을 포함하고 있는데, 조건에 따라 단순 객체 형태로 제공되는 경우가 있어 문제가 발생할 수 있습니다.
  2. Next.js의 타입 처리 방식 변경:

    • Next.js 최신 버전에서는 getStaticPropsgetServerSideProps를 통한 params가 Promise로 반환되어야 하고, 이에 맞춰 타입이 정의되어야 합니다.

해결 방법

  1. 타입 정의 수정:
    • getStaticPropsgetServerSideProps 사용 시, params의 타입을 Promise로 감싸서 반환해야 합니다. 예시로는 아래와 같습니다:
    ”`typescript
    import { GetStaticProps } from ‘next’;

export const getStaticProps: GetStaticProps = async (context) => {
const { params } = context;
// … 로직 수행
return {
props: { … },
};
};
- 속성params에 대해 타입 정의를Promise` 형식으로 변경하여 해결할 수 있습니다.

  1. 타입스크립트에서 명확한 타입 지정:

    • params: Promise<{ id: string }>으로 타입을 분명히 지정하고, 이를 비동기 처리에서 해제(a wait)를 통해 사용해야 할 수 있습니다.
  2. Next.js 공식 문서 참조:

    • 버전에 따른 변경 사항을 제대로 반영하고 있는지를 검토하기 위해 공식 문서를 참조해 주세요.

유사한 문제에 대한 기존 답변도 도움이 될 수 있습니다:
- checkFields, ‘default’>>() 에러?

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

진진님의 프로필 이미지
진진

작성한 질문수

질문하기