OTKRyu

Error about next/image

nexterror

목차
  1. next
  2. next/image
  3. next/image error
  4. 해결법
  5. 출처

next

next는 react를 csr, ssr 등의 여러 방식으로 취사선택하여 서비스를 제공할 수 있도록 도와주는 복합적인 프레임워크다. 처음 next의 설명을 들었을 때, 이게 어떻게 가능한가 싶었다. ssr을 하려면 적어도 서버가 있어야되는데, next의 설명에는 서버관련된 코드같은 것들이 거의 나와있지 않기 때문이다. 그래서 처음에는 뭔가 마법같은 기술이 있나하고 기대를 했지만, 실체는 코드를 기반으로 진짜 서버를 만들어서 돌려주는 것이었다.

next/image

next/image는 next에서 제공하는 컴포넌트 중 하나이다. 대부분 이미지를 다룰 때, 항상 고민하게 되는 것이 이미지 최적화인데, 이게 쉽지 않은 문제이고 뚜렷한 정답이랄게 없다. django 서버 만들 때 배웠던 imagekit를 이용하여 업로드될 때부터 화질을 제한해놓는 방식도 있을 수 있고, 요즘같이 반응형 서비스가 많은 경우에는 보이는 화면에 따라 이미지를 각기 사이즈별로 준비해둬야할 수도 있다. 어찌됐건 해결하기 쉽지 않은 문제 중 하나인데, next에서는 image가 어떤 사이즈로 들어갈 건지 명시만 해주면 next/image 컴포넌트를 사용하여 이미지를 조정해주는 기능을 제공한다. 잘 작동한다면 사용자 경험을 유지하면서, 페이지 로드 시간을 줄일 수 있다.

next/image error

다만 export를 이용하여 페이지를 배포할 시에 문제가 있다. 이 블로그 같은 경우 github pages를 활용하고 있는데, 사실 github pages는 static 파일을 제공해주는 데에 맞춰져있으므로, next에서 요구하는 빌드 후 서버를 통해 배포하는 것과는 거리가 멀다. 그렇다보니 아래와 같은 에러를 마주할 수 있었다

Error: Image Optimization using Next.js' default loader is not compatible with next export.

말 그대로 static한 파일로 만들어서 제공하는 export로는 next/image에 사용되는 기본 image loader로는 이미지 최적화가 불가능하다는 것이다.

해결법

왜 default loader로는 불가능할까 next 공식문서에 보면 그 해답이 나와있다. next도 webpack처럼 각기 파일 형태에 따라 loader를 사용하여 처리하는데, next가 기본적으로 사용하는 default loader는 build 시간을 단축하기 위해, 빌드 때 미리 최적화를 하는 것이 아니라, 그 이미지가 실제로 필요할 때 최적화하기 때문이다.

그래서 결국 이를 해결하기 위한 방법은 몇 가지 있는데 아래와 같다.

  1. next/image 컴포넌트를 사용하지 않는다.
  2. next의 default loader가 아닌 build시에 최적화를 할 수 있는 다른 loader를 사용한다.
  3. default loader가 제대로 일할 수 있는 배포환경으로 변경한다.

홈페이지에 사용하는 이미지가 많을 경우 1번은 답이 아닐 것이고 2, 3번을 고민해야하는 게 맞겠지만, 현재 이 블로그는 이미지라고는 로고 몇 개가 끝이기 때문에, 그냥 next/image 컴포넌트 쓰는 것을 포기했다.

대부분 다른 사람들을 2번은 방법을 많이 쓰는 것으로 보인다. 사실 이 에러 관련한 글은 많이 있는데, 이유까지 써놓은 글이 잘 없어서 포스트로 한 번 작성해봤다.

출처

더 자세한 정보를 원한다면 공식문서에 에러와 그 원인 및 해결방법까지 잘 써져 있다. (https://nextjs.org/docs/api-reference/next/image)