Nextjs 에서 서버 간 통신 (서버 to 서버) 할 때 경로 관리 주의사항

Nextjs 를 이용해서 api 통신을 할 때, 보안적인 문제 또는 외부에 있는 api 와 연결시에 주로 사용합니다.
참고로 Nextjs 에서는 pages/api 폴더 아래에 api 가 매핑되고 처리됩니다. 서버측 번들로만 구성되며, 클라이언트 측 번들 크기를 늘리지 않습니다.

API 경로 관리

절대 경로 사용: 서버 간 통신 시에는 절대 경로를 사용해야 합니다. 특히 외부 API를 호출하거나 내부 API 경로를 사용할 때, 상대 경로 대신 절대 경로를 사용해야 서버가 올바르게 요청을 처리할 수 있습니다.

서버에서 사용시에는 NEXT_PUBLIC_ 을 붙이지 않아도 됩니다.

const endpoint = `${process.env.BASE_URL}/api/some-endpoint`;

const handler = (req, res) => {
  try {
    const data = await get(endpoint)
    res.status(200).json({ data })
  } catch (err) {
    res.status(500).json({ error: 'failed to load data' })
  }
}

export default handler

환경 변수 활용: 배포 환경에 따라 URL이 다를 수 있기 때문에, Next.js에서 제공하는 .env 파일을 사용해 BASE_URL과 같은 환경 변수를 설정해 절대 경로를 관리하는 것이 좋습니다.

처리할 때 외부 API 호출은 절대경로, 내부는 상대경로로 해도 괜찮은 거를 인지하자!!