next export ๋ช…๋ น์–ด๋ฅผ ํ†ตํ•ด next.js ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜์„ static HTML์œผ๋กœ ๋งŒ๋“ค ์ˆ˜ ์žˆ๋‹ค. ์ด๋ ‡๊ฒŒ ๋งŒ๋“ค์–ด์ง„ Static HTML์€ Node.js ์„œ๋ฒ„์—†์ด ์šด์˜์ด ๊ฐ€๋Šฅํ•˜๋‹ค. ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ธฐ๋Šฅ์ด ํ•„์š”์—†๋‹ค๋ฉด, next export๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์ด ๊ถŒ์žฅ๋œ๋‹ค.

์œ„์™€ ๊ฐ™์€ ๊ธฐ๋Šฅ๋“ค์€ node.js ์„œ๋ฒ„๋ฅผ ํ•„์š”๋กœ ํ•˜๊ณ , ๋นŒ๋“œ ์‹œ ๊ณ„์‚ฐํ•  ์ˆ˜ ์—†๋Š” ๋กœ์ง์„ ํฌํ•จํ•˜๊ณ  ์žˆ๊ธฐ์—, ์œ„์™€ ๊ฐ™์€ ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉ์ค‘์ด๋ผ๋ฉด next export๋ฅผ ํ†ตํ•œ node.js ์„œ๋ฒ„ ์—†๋Š” ์šด์˜์ด ๊ฐ€๋Šฅํ•˜๋‹ค.

์‚ฌ์šฉ๋ฒ•

package.json์„ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ๋ณ€๊ฒฝํ•œ๋‹ค.

{
  ...
  "scripts":{
    "build": "next build && next export"
  }
  ...
}

์ดํ›„ npm run build๋ฅผ ์ˆ˜ํ–‰ํ•˜๋ฉด, out ๋””๋ ‰ํ„ฐ๋ฆฌ๊ฐ€ ์ƒ์„ฑ๋œ๋‹ค.

next build ๋™์•ˆ ์ƒ์„ฑ๋œ HTML ํŒŒ์ผ์„ next export๋ฅผ ํ†ตํ•ด out ๋””๋ ‰ํ„ฐ๋ฆฌ์— ๋ชจ์•„ export ํ•ด์ฃผ๋Š” ๊ฒƒ์ด๋‹ค.

๊ฒฝ์šฐ์— ๋”ฐ๋ผ์„œ๋Š” next.config.js์— exportPathMap๋ฅผ ์„ค์ •ํ•˜์—ฌ ์–ด๋–ค ํŽ˜์ด์ง€๋“ค์„ staticํ•˜๊ฒŒ ์ƒ์„ฑํ•ด๋‚ผ๊ฒƒ์ธ์ง€ ์ง€์ •์ด ๊ฐ€๋Šฅํ•˜๋‹ค. ์ด๋•Œ getStaticPaths๋ฅผ ์‚ฌ์šฉํ•œ ํŽ˜์ด์ง€๋Š” exportPathMap์—์„œ ์„ค์ •ํ•˜์ง€ ์•Š์•„๋„ ์ž๋™์œผ๋กœ HTML์„ ์ƒ์„ฑํ•œ๋‹ค.

์ง€์›ํ•˜๋Š” ๊ธฐ๋Šฅ

next export๋ฅผ ํ•˜๋”๋ผ๋„ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ธฐ๋Šฅ์€ ์ง€์›๋œ๋‹ค.

getInitialProps

getInitialProps๋ฅผ getStaticProps ๋Œ€์‹ ์— ์‚ฌ์šฉํ•ด๋„ ๋˜์ง€๋งŒ, ๋ช‡๊ฐ€์ง€ ์ฃผ์˜์‚ฌํ•ญ์ด ์กด์žฌํ•œ๋‹ค.

  • getInitialProps๋Š” getStaticProps๋‚˜ getStaticPaths์™€ ๊ฐ™์€ ํŽ˜์ด์ง€์—์„œ ํ•จ๊ป˜ ์“ฐ์ผ ์ˆ˜ ์—†๋‹ค. dynamic route๋ฅผ ์‚ฌ์šฉํ•ด์•ผํ•œ๋‹ค๋ฉด, getStaticPaths๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๋Œ€์‹ ์— exportPathMap์„ ์„ค์ •ํ•˜๋Š” ๊ฒƒ์ด ์ข‹๋‹ค.
  • getInitalProps๊ฐ€ export ๋‹จ๊ณ„์—์„œ ํ˜ธ์ถœ๋  ๋•Œ, context์˜ req, res๋Š” ๋น„์–ด์žˆ๋‹ค.
  • getInitialProps๋Š” ํด๋ผ์ด์–ธํŠธ ๋‹จ์—์„œ ๋„ค๋น„๊ฒŒ์ดํŠธ ๋  ๋•Œ ํ˜ธ์ถœ๋œ๋‹ค. ๋นŒ๋“œ์‹œ ํ˜ธ์ถœํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด getStaticProps๋ฅผ ์‚ฌ์šฉํ•ด์•ผํ•œ๋‹ค.
  • getInitialProps๋Š” node.js ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋‚˜ file-system์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์—†๋‹ค.

์œ„์™€ ๊ฐ™์€ ์ฃผ์˜์‚ฌํ•ญ์ด ์žˆ๊ธฐ์—, getInitialProps๋ณด๋‹ค๋Š” getStaticProps๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์ด ๊ถŒ์žฅ๋œ๋‹ค.

์ถœ์ฒ˜