{"id":672,"date":"2026-10-25T13:31:17","date_gmt":"2026-10-25T13:31:17","guid":{"rendered":"https:\/\/gilnas.synology.me\/wordpress\/672\/"},"modified":"2026-10-25T13:31:17","modified_gmt":"2026-10-25T13:31:17","slug":"nuxt-4-6-2%ec%97%90%ec%84%9c-ssr%c2%b7routerules%eb%a5%bc-%ec%a0%90%ea%b2%80%ed%95%98%eb%8a%94-%eb%b0%a9%eb%b2%95-nuxt-4-6-2-ssr-and-routerules-checks","status":"publish","type":"post","link":"https:\/\/gilnas.synology.me\/wordpress\/672\/","title":{"rendered":"Nuxt 4.6.2\uc5d0\uc11c SSR\u00b7routeRules\ub97c \uc810\uac80\ud558\ub294 \ubc29\ubc95 | Nuxt 4.6.2 SSR and RouteRules Checks"},"content":{"rendered":"
\"Nuxt<\/figure>\n

\ud575\uc2ec \ub2f5\ubcc0:<\/strong> Nuxt 4.6.2\uac00 10\uc6d4 16\uc77c \uacf5\uac1c\ub410\uc2b5\ub2c8\ub2e4. \uc774\ubc88 \ud328\uce58\ub294 \uc11c\ubc84 \uc544\uc77c\ub79c\ub4dc\uc758 useHeadSafe<\/code> \uaddc\uce59 \uc801\uc6a9, Nitro \ub77c\uc6b0\ud130 \ud30c\ub77c\ubbf8\ud130 \uc77d\uae30, \ub300\uc18c\ubb38\uc790 \uad6c\ubd84 \uc5c6\ub294 routeRules \ub9e4\uce6d, \ube4c\ub4dc \uacbd\ub85c\uc640 TypeScript \uc124\uc815 \ubcf4\uc874 \ub4f1 \uc6b4\uc601\uc5d0\uc11c \uc870\uc6a9\ud788 \ubb38\uc81c\ub97c \ub9cc\ub4e4 \uc218 \uc788\ub294 \ubd80\ubd84\uc744 \uace0\uce69\ub2c8\ub2e4. \uc774\ubbf8 Nuxt 4.6\uc744 \uc4f0\uace0 \uc788\ub2e4\uba74 \u201c\uc0c8 \uae30\ub2a5\uc744 \uc368 \ubcfc\uae4c\u201d\ubcf4\ub2e4 lockfile\uc744 \uac31\uc2e0\ud574 4.6.2\ub85c \uc62c\ub9ac\uace0, SSR\u00b7\uc11c\ubc84 API\u00b7\uce90\uc2dc \ub77c\uc6b0\ud2b8\uac00 \uc2e4\uc81c \ubc30\ud3ec \ud658\uacbd\uc5d0\uc11c \uac19\uc740 \ub3d9\uc791\uc744 \ud558\ub294\uc9c0 \uba3c\uc800 \ud655\uc778\ud560 \ub54c\uc785\ub2c8\ub2e4.<\/p>\n

\uc774\ubc88 3\uc77c \uc8fc\uae30\uc758 Nuxt \uc18c\uc2dd\uc5d0\uc11c \ub354 \uc911\uc694\ud55c \ub9e5\ub77d\uc740 \ud328\uce58 \ud558\ub098\uac00 \uc544\ub2d9\ub2c8\ub2e4. Nuxt 4.6\uc740 nuxt\/server<\/code>\ub77c\ub294 \uacf5\uac1c \uc11c\ubc84 \ud45c\uba74\uc744 \ub9cc\ub4e4\uba70 Nuxt 5\uc758 Nitro v3\u00b7H3 v2 \uc804\ud658\uc744 \uc900\ube44\ud588\uace0, 4.6.2\ub294 \uadf8 \uacbd\uacc4 \uc704\uc5d0\uc11c routeRules, server island, \uac1c\ubc1c\u00b7\ube4c\ub4dc \uacbd\ub85c\ub97c \ub2e4\ub4ec\uc5c8\uc2b5\ub2c8\ub2e4. \uc11c\ubc84 \ud578\ub4e4\ub7ec\uc5d0\uc11c h3<\/code>\uc758 \ub0b4\ubd80 \ub3d9\uc791\uc5d0 \uc9c1\uc811 \uae30\ub300\uace0 \uc788\uac70\ub098, URL \ub300\uc18c\ubb38\uc790\uc640 \ud504\ub85d\uc2dc \uaddc\uce59\uc744 \ub290\uc2a8\ud558\uac8c \ub2e4\ub8e8\ub294 \ud504\ub85c\uc81d\ud2b8\ub77c\uba74 \ud68c\uadc0 \ud14c\uc2a4\ud2b8\uac00 \ud544\uc694\ud55c \uc774\uc720\uc785\ub2c8\ub2e4.<\/p>\n

\uacb0\ub860\uc740 \ub2e8\uc21c\ud569\ub2c8\ub2e4. \uc758\uc874\uc131 \uc5c5\ub370\uc774\ud2b8\ub294 \ud558\ub418 production\uc5d0 \ubc14\ub85c \ubc00\uc5b4 \ub123\uc9c0 \ub9d0\uace0, nuxt.config.ts<\/code>\uc758 routeRules\uc640 server\/api<\/code> \ud578\ub4e4\ub7ec, SSR \ud5e4\ub354, CI\uc758 clean install\uc744 \ud55c \ubb36\uc74c\uc73c\ub85c \uc810\uac80\ud558\uc138\uc694. \ubcf4\uc548 \ud328\uce58 \ub54c \ud55c \ubc88 \uc62c\ub838\ub2e4\uace0 \uba48\ucd94\uba74 \uc548 \ub429\ub2c8\ub2e4. Nuxt \ud300\uc740 \uc55e\uc120 \ubcf4\uc548 \uad8c\uace0\uc5d0\uc11c lockfile \uac31\uc2e0\uacfc @nuxt\/devtools<\/code> \ubc84\uc804\uae4c\uc9c0 \uba85\uc2dc\uc801\uc73c\ub85c \ud655\uc778\ud558\ub77c\uace0 \uc548\ub0b4\ud588\uc2b5\ub2c8\ub2e4.<\/p>\n

\ubb34\uc2a8 \uc77c\uc774 \uc788\uc5c8\ub098<\/h2>\n

Nuxt \ud300\uc740 2026\ub144 10\uc6d4 16\uc77c<\/strong> GitHub \uacf5\uc2dd \ub9b4\ub9ac\uc2a4\ub85c Nuxt v4.6.2<\/strong>\ub97c \ubc30\ud3ec\ud588\uc2b5\ub2c8\ub2e4. \ubcc0\uacbd \ubaa9\ub85d\uc5d0\ub294 server island head\uc5d0 useHeadSafe<\/code> \uaddc\uce59\uc744 \uc801\uc6a9\ud558\ub294 Nitro \uc218\uc815, H3\uac00 \ub9e4\uce6d\ud55c \uacbd\ub85c\uc5d0\uc11c router params\ub97c \uc77d\ub294 \uc218\uc815, \ubbfc\uac10 \ub77c\uc6b0\ud305\uc774 \uc544\ub2d0 \ub54c routeRules\ub97c \ub300\uc18c\ubb38\uc790 \uad6c\ubd84 \uc5c6\uc774 \ub9e4\uce6d\ud558\ub294 \uc218\uc815\uc774 \ud3ec\ud568\ub429\ub2c8\ub2e4. \uc774 \ubc16\uc5d0\ub3c4 \uc774\ub3d9\ub41c \ube4c\ub4dc \ub514\ub809\ud130\ub9ac\uc5d0\uc11c server tsconfig\ub97c \ubcf4\uc874\ud558\uace0, Nitro v2\uc5d0\uc11c \ud30c\uc77c\uba85\uc73c\ub85c \uc720\ub3c4\ud55c \ud578\ub4e4\ub7ec HTTP \uba54\uc11c\ub4dc\ub97c \uc18c\ubb38\uc790\ub85c \ucc98\ub9ac\ud558\ub294 \ud56d\ubaa9\uc774 \ub4e4\uc5b4\uac14\uc2b5\ub2c8\ub2e4. \uc804\uccb4 \ud56d\ubaa9\uc740 Nuxt v4.6.2 \uacf5\uc2dd \ub9b4\ub9ac\uc2a4 \ub178\ud2b8<\/a>\uc5d0\uc11c \ud655\uc778\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n

\ubc14\ub85c \uc55e\uc758 Nuxt 4.6\uc740 nuxt\/server<\/code>\ub97c \ud1b5\ud574 \uc11c\ubc84 API\uc758 \uc18c\uc720\uad8c\uc744 Nuxt \ucabd\uc73c\ub85c \uc815\ub9ac\ud558\ub294 \ud070 \ubcc0\ud654\uc600\uc2b5\ub2c8\ub2e4. \uae30\ubcf8 \uad6c\ud604\uc740 \uc5ec\uc804\ud788 Nitro\uc9c0\ub9cc, \uc571\uacfc \ubaa8\ub4c8\uc774 h3<\/code>\u00b7nitropack<\/code>\uc5d0 \ubc14\ub85c \ubb36\uc774\uc9c0 \uc54a\uac8c \ud574 Nuxt 5 \uc804\ud658\uc744 \ubd80\ub4dc\ub7fd\uac8c \ud558\ub824\ub294 \ubc29\ud5a5\uc785\ub2c8\ub2e4. \uacf5\uc2dd \ubc1c\ud45c\ub294 \uc77c\ubd80 helper\uc758 \ub3d9\uc791 \ucc28\uc774\ub3c4 \uba85\uc2dc\ud569\ub2c8\ub2e4. \uc608\ub97c \ub4e4\uc5b4 sendRedirect<\/code>\ub294 \uc751\ub2f5\uc744 \ubc18\ud658\ud558\uace0, createError<\/code>\uc758 \uc778\uc790 \ubaa8\uc591\uacfc \ud5e4\ub354 \uc811\uadfc \ubc29\uc2dd\uc774 \ub2e4\ub985\ub2c8\ub2e4. Nuxt 4.6 \uacf5\uc2dd \ubc1c\ud45c<\/a>\uc640 \uc5c5\uadf8\ub808\uc774\ub4dc \ud45c\ub97c \ud568\uaed8 \ubd10\uc57c \ub2e8\uc21c import \uce58\ud658\uc73c\ub85c \ub05d\ub098\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4.<\/p>\n

\ubcf4\uc548 \ub9e5\ub77d\ub3c4 \ub0a8\uc544 \uc788\uc2b5\ub2c8\ub2e4. Nuxt\ub294 4.5.1\uacfc 3.21.10\uc5d0\uc11c \uc11c\ubc84 \uce21 RCE, server island props, route rule \uad8c\ud55c \uc6b0\ud68c, \uce90\uc2dc \ud398\uc774\uc9c0\uc758 \uc0ac\uc6a9\uc790 \uac04 payload \ub178\ucd9c, \uac1c\ubc1c \uc11c\ubc84 \uc815\ubcf4 \ub178\ucd9c \ub4f1\uc744 \ub2e4\ub8e8\ub294 \ubcf4\uc548 \ud328\uce58\ub97c \ubc1c\ud45c\ud588\uace0, \ubcc4\ub3c4\ub85c @nuxt\/devtools@3.3.1<\/code>\uc758 \uce58\uba85\uc801\uc778 \uac1c\ubc1c \uc804\uc6a9 RCE\ub3c4 \uc5b8\uae09\ud588\uc2b5\ub2c8\ub2e4. \uacf5\uc2dd \ubcf4\uc548 \ud328\uce58 \uacf5\uc9c0<\/a>\ub294 npx nuxt upgrade --dedupe<\/code> \ub4a4 lockfile\uc744 \uc0c8\ub85c \ud655\uc778\ud558\ub77c\uace0 \uad8c\ud569\ub2c8\ub2e4. \uacf5\uac1c\ub41c Nuxt \ubcf4\uc548 \uad8c\uace0 \ubaa9\ub85d<\/a>\ub3c4 \ud604\uc7ac \uc601\ud5a5 \ud310\ub2e8\uc758 1\ucc28 \ucd9c\ucc98\uc785\ub2c8\ub2e4.<\/p>\n

\uc65c \uc911\uc694\ud55c\uac00<\/h2>\n

routeRules\uc640 server\/api\ub294 \ud504\ub860\ud2b8\uc5d4\ub4dc \uc124\uc815\ucc98\ub7fc \ubcf4\uc774\uc9c0\ub9cc \uc2e4\uc81c\ub85c\ub294 CDN \uce90\uc2dc, \uc778\uc99d, \ub9ac\ub2e4\uc774\ub809\ud2b8, SSR \uc751\ub2f5 \ud5e4\ub354\ub97c \uc815\ud558\ub294 \uc11c\ubc84 \uc815\ucc45\uc785\ub2c8\ub2e4. \uc608\ub97c \ub4e4\uc5b4 \/api\/Admin<\/code>\uacfc \/api\/admin<\/code>\ub97c \ud504\ub85d\uc2dc\u00b7WAF\u00b7Nitro\uac00 \uac01\uac01 \ub2e4\ub974\uac8c \ud574\uc11d\ud558\uba74, \ud2b9\uc815 \ud658\uacbd\uc5d0\uc11c\ub9cc \uc778\uc99d \ub610\ub294 \uce90\uc2dc \uc815\ucc45\uc774 \ube44\ucf1c \uac08 \uc218 \uc788\uc2b5\ub2c8\ub2e4. 4.6.2\uc758 \ub300\uc18c\ubb38\uc790 \ub9e4\uce6d \uc218\uc815\uc740 \uc774 \ubb38\uc81c\ub97c \uc790\ub3d9\uc73c\ub85c \ud574\uacb0\ud55c\ub2e4\ub294 \ubcf4\uc99d\uc774 \uc544\ub2c8\ub77c, \ud504\ub85c\uc81d\ud2b8\uac00 URL \ud45c\uae30\uc640 routeRules \ud14c\uc2a4\ud2b8\ub97c \uba85\uc2dc\ud574\uc57c \ud55c\ub2e4\ub294 \uc2e0\ud638\ub85c \uc77d\ub294 \ud3b8\uc774 \ub9de\uc2b5\ub2c8\ub2e4.<\/p>\n

\uc131\ub2a5\ub3c4 \uac19\uc740 \uad00\uc810\uc785\ub2c8\ub2e4. SSR \ud398\uc774\uc9c0\uc758 payload\uac00 \ucee4\uc9c0\uac70\ub098 server island\uac00 \uc608\uc0c1\uacfc \ub2e4\ub974\uac8c head\ub97c \uc870\uc791\ud558\uba74 LCP, \uce90\uc2dc \uc801\uc911\ub960, \uac80\uc0c9 \ud06c\ub864\ub7ec\uac00 \ubcf4\ub294 \uba54\ud0c0 \ud0dc\uadf8\uae4c\uc9c0 \ud754\ub4e4\ub9b4 \uc218 \uc788\uc2b5\ub2c8\ub2e4. Nuxt 4.6\uc740 \uac1c\ubc1c \uc911 100kB\ub97c \ub118\ub294 \ud398\uc774\uc9c0 payload \uacbd\uace0\uc640 noScripts<\/code> \uad00\ub828 \uacbd\uace0\ub97c \ucd94\uac00\ud588\uc2b5\ub2c8\ub2e4. \uacbd\uace0\ub97c \ub044\ub294 \ub300\uc2e0, \uacbd\ub85c\ubcc4 HTML \ud06c\uae30\uc640 payload \ud06c\uae30\ub97c CI \ub610\ub294 preview\uc5d0\uc11c \uc218\uc9d1\ud558\uba74 \uc2e4\uc81c \uc6d0\uc778\uc744 \ucc3e\uae30 \uc26c\uc6cc\uc9d1\ub2c8\ub2e4.<\/p>\n

\uc5c5\ub370\uc774\ud2b8\ub294 package.json\uc774 \uc544\ub2c8\ub77c lockfile\uae4c\uc9c0 \ud55c \ubcc0\uacbd\uc785\ub2c8\ub2e4<\/h3>\n

package.json<\/code>\uc5d0\uc11c Nuxt \ubc94\uc704\ub97c \uc62c\ub838\ub294\ub370 CI\uc640 \ub85c\uceec \uacb0\uacfc\uac00 \ub2e4\ub974\uba74 \uba3c\uc800 lockfile\uc744 \ubd05\ub2c8\ub2e4. \uacf5\uc2dd \uad8c\uc7a5 \uba85\ub839\uc778 npx nuxt upgrade --dedupe<\/code>\ub294 Nuxt\uc640 \uc911\ubcf5 \uc758\uc874\uc131\uc744 \ud568\uaed8 \uc815\ub9ac\ud569\ub2c8\ub2e4. \uadf8 \ub4a4\uc5d0\ub294 pnpm install --frozen-lockfile<\/code> \ub610\ub294 \uc0ac\uc6a9\ud558\ub294 \ud328\ud0a4\uc9c0 \ub9e4\ub2c8\uc800\uc758 \uace0\uc815 \uc124\uce58\ub85c \uc0c8 \uc6cc\ud06c\uc2a4\ud398\uc774\uc2a4\ub97c \ub9cc\ub4e4\uace0, \uc2e4\uc81c\ub85c \uc124\uce58\ub41c nuxt<\/code>, nitro<\/code>, @nuxt\/devtools<\/code> \ubc84\uc804\uc744 \ucd9c\ub825\ud574 CI \uc544\ud2f0\ud329\ud2b8\uc5d0 \ub0a8\uae30\uc138\uc694. \uac1c\ubc1c \ub3c4\uad6c\ub294 \u201cproduction \ubc88\ub4e4\uc5d0 \uc5c6\uc73c\ub2c8 \uad1c\ucc2e\ub2e4\u201d\ub85c \ub05d\ub098\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. \uac1c\ubc1c \uc11c\ubc84\uac00 LAN\uc5d0 \uc5f4\ub9ac\uac70\ub098 \ube0c\ub77c\uc6b0\uc800\uc640 \uac19\uc740 \ud638\uc2a4\ud2b8\uc5d0\uc11c \ub3d9\uc791\ud560 \ub54c\ub294 \ubcc4\ub3c4 \uacf5\uaca9\uba74\uc785\ub2c8\ub2e4.<\/p>\n

\ub864\ubc31\ub3c4 commit \ud558\ub098\ub85c \uac00\ub2a5\ud574\uc57c \ud569\ub2c8\ub2e4. \uc5c5\uadf8\ub808\uc774\ub4dc PR\uc5d0\ub294 lockfile\uacfc \uc2a4\ub0c5\uc0f7 \ubcc0\ud654, preview URL\uc758 \ud575\uc2ec \uacbd\ub85c \uacb0\uacfc\ub97c \uac19\uc774 \ub123\uace0, \ubc30\ud3ec \ubb38\uc81c \ub54c \uc774\uc804 \uc774\ubbf8\uc9c0\uc640 \uc774\uc804 lockfile\uc744 \uadf8\ub300\ub85c \ub418\ub3cc\ub9b4 \uc218 \uc788\uac8c \ud569\ub2c8\ub2e4. \uc758\uc874\uc131 \uce90\uc2dc \ud0a4\uac00 lockfile \ud574\uc2dc\ub97c \ud3ec\ud568\ud558\ub294\uc9c0\ub3c4 CI \uc124\uc815\uc5d0\uc11c \ud655\uc778\ud558\uc138\uc694.<\/p>\n

routeRules\ub294 URL \ud45c\uae30\uc640 SSR \uc751\ub2f5\uc73c\ub85c \ud14c\uc2a4\ud2b8\ud569\ub2c8\ub2e4<\/h3>\n

nuxt.config.ts<\/code>\uc758 \uaddc\uce59\uc740 \ubcf4\uae30 \uc88b\uc740 \uc124\uc815\uc774 \uc544\ub2c8\ub77c \uacf5\uac1c \uc778\ud130\ud398\uc774\uc2a4\uc785\ub2c8\ub2e4. \ud2b9\ud788 cache, redirect, headers, proxy, prerender\uac00 \uc11e\uc774\uba74 \ud55c \uaddc\uce59\uc758 \uc6b0\uc120\uc21c\uc704\ub97c \uc0ac\ub78c\uc774 \uae30\uc5b5\ud558\uae30 \uc5b4\ub835\uc2b5\ub2c8\ub2e4. URL\uc744 \uc18c\ubb38\uc790\ub85c \uac15\uc81c\ud560\uc9c0, \uc6d0\ub798 URL\uc744 \ud5c8\uc6a9\ud560\uc9c0 \uba3c\uc800 \uc815\ud558\uace0, \ub300\ubb38\uc790\uac00 \uc11e\uc778 \uacbd\ub85c\uae4c\uc9c0 \ud14c\uc2a4\ud2b8 \ud45c\uc5d0 \ub123\uc73c\uc138\uc694.<\/p>\n

export default defineNuxtConfig({\n  routeRules: {\n    '\/account\/**': { headers: { 'Cache-Control': 'private, no-store' } },\n    '\/docs\/**': { swr: 600 },\n    '\/api\/**': { cors: true }\n  }\n})<\/code><\/pre>\n
\uc774 \uc124\uc815\uc774 \uc788\ub354\ub77c\ub3c4 preview\uc5d0\uc11c curl -I<\/code>\ub85c SSR \uc751\ub2f5\uc758 Cache-Control, Location, Vary\ub97c \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4. \ub85c\uadf8\uc778\ud55c \uc0ac\uc6a9\uc790 \ud398\uc774\uc9c0\uac00 CDN \uce90\uc2dc\uc5d0 \ub4e4\uc5b4\uac00\uc9c0 \uc54a\ub294\uc9c0, \/Docs\/intro<\/code> \uac19\uc740 \ubcc0\ud615 URL\uc5d0\uc11c \uac19\uc740 \uc815\ucc45\uc774 \uc801\uc6a9\ub418\ub294\uc9c0, \ud504\ub85d\uc2dc \uc55e\ub2e8\uc774 \uc6d0\ub798 \uacbd\ub85c\ub97c \ubcf4\uc874\ud558\ub294\uc9c0\ub97c \ud14c\uc2a4\ud2b8\ud569\ub2c8\ub2e4. 4.6.2\uc758 router params \uc218\uc815\uacfc \ud568\uaed8 \ub3d9\uc801 server\/api\/users\/[id].get.ts<\/code>\ub3c4 \uc22b\uc790\u00b7\uc778\ucf54\ub529\u00b7\ub300\uc18c\ubb38\uc790 \ucf00\uc774\uc2a4\ub97c \ub123\uc5b4 \uac80\uc99d\ud558\uba74 \uc88b\uc2b5\ub2c8\ub2e4.<\/p>\n
server\/api\ub294 nuxt\/server \uc774\ud589 \uc5ec\ubd80\ub97c \uc11e\uc9c0 \ub9d0\uace0 \ud30c\uc77c \ub2e8\uc704\ub85c \uc815\ud569\ub2c8\ub2e4<\/h3>\n
Nuxt 4.6\uc758 nuxt\/server<\/code>\ub294 \uc7a5\uae30\uc801\uc73c\ub85c \uc88b\uc740 \uc774\ud589 \uc9c0\uc810\uc774\uc9c0\ub9cc, \ubaa8\ub4e0 handler import\ub97c \ud55c PR\uc5d0\uc11c \ubc14\uafb8\ub294 \uc77c\uc740 \uad8c\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. \uc2e0\uaddc API \ud558\ub098 \ub610\ub294 \ubcc0\uacbd \uc608\uc815\uc778 \ubaa8\ub4c8\ubd80\ud130 \uc2dc\uc791\ud574 \uae30\uc874 h3<\/code> \ud638\ucd9c\uacfc\uc758 \ub3d9\uc791 \ucc28\uc774\ub97c \ud14c\uc2a4\ud2b8\ud558\uc138\uc694. createError<\/code>, \ub9ac\ub2e4\uc774\ub809\ud2b8, response header, event \ud0c0\uc785\uc740 \ub2e8\uc704 \ud14c\uc2a4\ud2b8\ubfd0 \uc544\ub2c8\ub77c \uc2e4\uc81c Nitro preset\uc5d0\uc11c \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4. edge\u00b7node\u00b7serverless \ubc30\ud3ec\ub294 \uc2a4\ud2b8\ub9ac\ubc0d\uacfc \ud5e4\ub354 \ucc98\ub9ac\uc5d0\uc11c \ucc28\uc774\uac00 \ub0a0 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n
\ud30c\uc77c \uc774\ub984\ub3c4 API \uacc4\uc57d\uc785\ub2c8\ub2e4. server\/api\/orders\/[id].get.ts<\/code>\ucc98\ub7fc \uba54\uc11c\ub4dc\ub97c \ud30c\uc77c\uba85\uc5d0 \ud45c\uc2dc\ud558\uace0, \uc608\uc0c1\ud558\uc9c0 \uc54a\uc740 \uba54\uc11c\ub4dc\ub294 405\uac00 \ub418\ub294\uc9c0 \ud655\uc778\ud569\ub2c8\ub2e4. 4.6.2\uc5d0\ub294 Nitro v2\uc5d0\uc11c \ud30c\uc77c\uba85 \uc720\ub3c4 \uba54\uc11c\ub4dc\ub97c \uc18c\ubb38\uc790\ub85c \ucc98\ub9ac\ud558\ub294 \uc218\uc815\uc774 \uc788\uc73c\ubbc0\ub85c, \ub300\ubb38\uc790 \ud655\uc7a5\uc790\ub098 \uc0ac\uc6a9\uc790 \uc815\uc758 \uc11c\ubc84 \ub77c\uc6b0\ud2b8\uac00 \uc788\ub2e4\uba74 build \uc0b0\ucd9c\ubb3c\uae4c\uc9c0 \uac80\uc0ac\ud574\uc57c \ud569\ub2c8\ub2e4. \uc778\uc99d\uc740 middleware\uc5d0\uc11c\ub9cc \ub9c9\ub294\ub2e4\uace0 \uc0dd\uac01\ud558\uc9c0 \ub9d0\uace0 handler\uc5d0\ub3c4 \uc0ac\uc6a9\uc790\u00b7\ud14c\ub10c\ud2b8\u00b7\uc18c\uc720\uad8c \uac80\uc0ac\ub97c \ub461\ub2c8\ub2e4.<\/p>\n
server island\uc640 head\ub294 \ud654\uba74 \ud14c\uc2a4\ud2b8\ub9cc\uc73c\ub85c \ucda9\ubd84\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4<\/h3>\n
server island\ub294 \uc11c\ubc84\uc5d0\uc11c \uc77c\ubd80\ub97c \ub3c5\ub9bd \ub80c\ub354\ub9c1\ud558\ub294 \uae30\ub2a5\uc774\ub77c, \ud654\uba74\uc774 \ubcf4\uc778\ub2e4\uace0 head\uac00 \uc815\uc0c1\uc774\ub77c\ub294 \ub73b\uc740 \uc544\ub2d9\ub2c8\ub2e4. 4.6.2\uac00 useHeadSafe<\/code> \uaddc\uce59\uc744 server island head\uc5d0 \uc801\uc6a9\ud55c \uac83\uc740 \ub3d9\uc801 \uba54\ud0c0 \uc815\ubcf4\uc758 \uc548\uc804\ud55c \ucc98\ub9ac\uc640 \uc5f0\uacb0\ub429\ub2c8\ub2e4. \uc0ac\uc6a9\uc790 \uc785\ub825\uc774\ub098 CMS \ubcf8\ubb38\uc73c\ub85c title, meta, script \uad00\ub828 \uac12\uc744 \ub9cc\ub4e4\uace0 \uc788\ub2e4\uba74 preview HTML\uc758 <head><\/code>\ub97c \uc2a4\ub0c5\uc0f7\uc73c\ub85c \ube44\uad50\ud558\uace0, \ud5c8\uc6a9\ud558\uc9c0 \uc54a\uc740 \ud0dc\uadf8\u00b7\uc18d\uc131\uc774 \ub4e4\uc5b4\uc624\uc9c0 \uc54a\ub294\uc9c0 \ud655\uc778\ud558\uc138\uc694.<\/p>\n
\uc774 \uc601\uc5ed\uc740 SEO\uc640 \ubcf4\uc548\uc774 \ub9cc\ub0a9\ub2c8\ub2e4. SSR HTML\uc5d0 canonical, robots, Open Graph \uac12\uc774 \ub9de\ub294\uc9c0 \ud655\uc778\ud558\ub418, \uc678\ubd80 \uac12\uc744 \uadf8\ub300\ub85c head\uc5d0 \ud758\ub824\ubcf4\ub0b4\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. \ucf58\ud150\uce20 \ud3b8\uc9d1 \ud654\uba74\uc5d0\uc11c \ud544\uc694\ud55c \ud544\ub4dc\ub294 \uad6c\uc870\ud654\ud558\uace0, Nuxt \ucabd\uc5d0\uc11c\ub294 \ud5c8\uc6a9 \ubaa9\ub85d\uc5d0 \uc5c6\ub294 \uac12\uc744 \uc81c\uac70\ud558\ub294 \ubc29\ud5a5\uc774 \uc720\uc9c0\ubcf4\uc218\uc5d0 \ub0ab\uc2b5\ub2c8\ub2e4. \ud074\ub77c\uc774\uc5b8\ud2b8 hydration \ub4a4\uc758 \ud654\uba74\ubfd0 \uc544\ub2c8\ub77c JavaScript \uc5c6\uc774 \ubc1b\uc740 HTML\uc744 \uae30\uc900\uc73c\ub85c \ud14c\uc2a4\ud2b8\ud574\uc57c \uac80\uc0c9 \uc5d4\uc9c4\uacfc \uacf5\uc720 \ubbf8\ub9ac\ubcf4\uae30\uc758 \uacb0\uacfc\ub97c \uc54c \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n
\uc131\ub2a5 \uac1c\uc120\uc740 \uad00\uce21\uac12\uc744 \ub0a8\uae34 \ub4a4\uc5d0 \uc801\uc6a9\ud569\ub2c8\ub2e4<\/h3>\n
Nuxt 4.6\uc740 typed $fetch<\/code>, payload \uacbd\uace0, prefetch \uc2a4\ucf00\uc904\ub7ec \ub4f1 \uac1c\ubc1c \uacbd\ud5d8\uacfc \uc131\ub2a5\uc5d0 \uc601\ud5a5\uc744 \uc8fc\ub294 \uae30\ubc18\uc744 \ub113\ud614\uc2b5\ub2c8\ub2e4. \ud558\uc9c0\ub9cc \ud0c0\uc785\uc774 \ucd18\ucd18\ud574\uc84c\ub2e4\uace0 API\uac00 \ube68\ub77c\uc9c4 \uac83\uc740 \uc544\ub2d9\ub2c8\ub2e4. experimental.strictRouteTypes<\/code>\ub098 \uc0c8 typed fetch\ub97c \ucf1c\uae30 \uc804\uc5d0\ub294 \uc0dd\uc131\ub41c \ud0c0\uc785 \uc624\ub958\uac00 \uc2e4\uc81c \uc798\ubabb\ub41c \ud638\ucd9c\uc744 \uc7a1\ub294\uc9c0, Date \uac19\uc740 \uc9c1\ub82c\ud654 \uac12\uc774 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uc11c string\uc73c\ub85c \ubcf4\uc774\ub294 \ubcc0\ud654\uac00 \uc5c6\ub294\uc9c0 \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n
CI\/CD\uc5d0\uc11c\ub294 \ub300\ud45c SSR \ud398\uc774\uc9c0 3\uac1c\uc640 \uc778\uc99d API 2\uac1c\ub9cc \uba3c\uc800 \uc815\ud574 TTFB, HTML \ubc14\uc774\ud2b8, payload \ubc14\uc774\ud2b8, hydration \uc624\ub958, 5xx\ub97c \uc218\uc9d1\ud558\uc138\uc694. \ubc30\ud3ec \uc9c1\ud6c4\uc5d0\ub294 \uac19\uc740 \uc9c0\ud45c\ub97c \uc774\uc804 \ub9b4\ub9ac\uc2a4\uc640 \ube44\uad50\ud569\ub2c8\ub2e4. \uce90\uc2dc\ub97c \ucf20 routeRules\ub294 \uce90\uc2dc hit\/miss\uc640 \uc0ac\uc6a9\uc790\ubcc4 \ub370\uc774\ud130 \ud63c\uc785 \uc5ec\ubd80\ub97c \ub530\ub85c \ubd10\uc57c \ud569\ub2c8\ub2e4. \ube60\ub978 \ud398\uc774\uc9c0 \ud558\ub098\ubcf4\ub2e4 \ub2e4\ub978 \uc0ac\uc6a9\uc790 \ub370\uc774\ud130\uac00 \uc11e\uc774\uc9c0 \uc54a\ub294 \ud398\uc774\uc9c0\uac00 \uc6b0\uc120\uc785\ub2c8\ub2e4.<\/p>\n
\uac1c\ubc1c\uc790 \uc2e4\ud589 \uacc4\ud68d<\/h2>\n
    \n
  1. npx nuxt upgrade --dedupe<\/code> \ud6c4 lockfile\uc744 \ucee4\ubc0b\ud558\uace0, \uae68\ub057\ud55c CI \uc124\uce58\uc5d0\uc11c Nuxt\u00b7Nitro\u00b7DevTools \uc2e4\ubc84\uc804\uc744 \ud655\uc778\ud569\ub2c8\ub2e4.<\/li>\n
  2. nuxt.config.ts<\/code>\uc758 routeRules\ub97c \ud45c\ub85c \uc62e\uaca8 cache, redirect, headers, proxy, prerender\uc758 \uc18c\uc720 \uacbd\ub85c\ub97c \uc815\ub9ac\ud569\ub2c8\ub2e4.<\/li>\n
  3. \ub300\uc18c\ubb38\uc790\u00b7URL \uc778\ucf54\ub529\u00b7\ub3d9\uc801 \ud30c\ub77c\ubbf8\ud130\ub97c \ud3ec\ud568\ud55c server\/api<\/code> \ud1b5\ud569 \ud14c\uc2a4\ud2b8\ub97c \ucd94\uac00\ud569\ub2c8\ub2e4.<\/li>\n
  4. preview\uc5d0\uc11c \ub85c\uadf8\uc778\/\ube44\ub85c\uadf8\uc778 SSR \uc751\ub2f5\uc758 Cache-Control, Vary, Location, canonical\uc744 \ud5e4\ub354\uc640 HTML\ub85c \uac80\uc0ac\ud569\ub2c8\ub2e4.<\/li>\n
  5. server island\ub97c \uc4f0\ub294 \ud398\uc774\uc9c0\ub294 head \uc2a4\ub0c5\uc0f7\uacfc JavaScript \ube44\ud65c\uc131 HTML \uac80\uc0ac\ub97c CI\uc5d0 \ub123\uc2b5\ub2c8\ub2e4.<\/li>\n
  6. \uac1c\ubc1c \uc11c\ubc84\ub294 \uc2e0\ub8b0\ud558\uc9c0 \uc54a\ub294 \ub124\ud2b8\uc6cc\ud06c\uc5d0 \ub178\ucd9c\ud558\uc9c0 \ub9d0\uace0, DevTools \ubc84\uc804\uacfc --host<\/code> \uc0ac\uc6a9 \uc5ec\ubd80\ub97c \ud300 \ud45c\uc900\uc73c\ub85c \uae30\ub85d\ud569\ub2c8\ub2e4.<\/li>\n
  7. \ub300\ud45c \uacbd\ub85c\uc758 TTFB\u00b7payload \ud06c\uae30\u00b75xx\u00b7hydration \uc624\ub958\ub97c \ubc30\ud3ec \uc804\ud6c4 \ube44\uad50\ud558\uace0, \uae30\uc900 \uc545\ud654 \uc2dc \uc774\uc804 \uc774\ubbf8\uc9c0\ub85c \ub864\ubc31\ud569\ub2c8\ub2e4.<\/li>\n<\/ol>\n
    \ub9ac\uc2a4\ud06c\uc640 \ud55c\uacc4<\/h2>\n
    v4.6.2\ub294 patch release\uc774\uc9c0\ub9cc \uc571\uc758 \ubaa8\ub4c8 \uc870\ud569, Nitro preset, \ud504\ub85d\uc2dc, CDN \uc124\uc815\uae4c\uc9c0 \uac19\uc740 \ubc29\uc2dd\uc73c\ub85c \uace0\uccd0 \uc8fc\uc9c0\ub294 \uc54a\uc2b5\ub2c8\ub2e4. \ud2b9\ud788 \uce90\uc2dc\uc640 routeRules\ub294 \ub85c\uceec \uac1c\ubc1c \uc11c\ubc84\uc640 production CDN\uc5d0\uc11c \ub2e4\ub974\uac8c \ubcf4\uc77c \uc218 \uc788\uc2b5\ub2c8\ub2e4. Nuxt 4.6\uc758 nuxt\/server<\/code> \uc774\ud589\ub3c4 \uc120\ud0dd \uc0ac\ud56d\uc785\ub2c8\ub2e4. \ud604\uc7ac \uc548\uc815\uc801\uc73c\ub85c \ub3d9\uc791\ud558\ub294 handler\ub97c \ubb34\ub9ac\ud574\uc11c \ud55c \ubc88\uc5d0 \uc62e\uae30\uae30\ubcf4\ub2e4, Nuxt 5 \uc900\ube44\uac00 \ud544\uc694\ud55c \uc0c8 \ucf54\ub4dc\ubd80\ud130 \ud638\ud658\uc131 \ud45c\ub97c \ud655\uc778\ud558\uba70 \uc62e\uae30\ub294 \ud3b8\uc774 \uc548\uc804\ud569\ub2c8\ub2e4.<\/p>\n
    \ub864\ubc31 \uae30\uc900\uc740 \uba85\ud655\ud574\uc57c \ud569\ub2c8\ub2e4. \uc778\uc99d SSR \ud398\uc774\uc9c0\uc5d0\uc11c private cache \ud5e4\ub354\uac00 \uc0ac\ub77c\uc9c0\uac70\ub098, routeRules \ud14c\uc2a4\ud2b8\uac00 \ubcc0\ud558\uac70\ub098, payload\u00b7TTFB\uac00 \uc815\ud55c \uae30\uc900\ubcf4\ub2e4 \ub098\ube60\uc9c0\uac70\ub098, DevTools \uad00\ub828 \ucde8\uc57d \ubc84\uc804\uc774 lockfile\uc5d0 \ub0a8\uc73c\uba74 \ubc30\ud3ec\ub97c \uc911\uc9c0\ud569\ub2c8\ub2e4. \uacf5\uc2dd \ub9b4\ub9ac\uc2a4 \ub178\ud2b8\uc640 \ubcf4\uc548 \uad8c\uace0\ub294 \ubcc0\uacbd\ub420 \uc218 \uc788\uc73c\ubbc0\ub85c, \uc5c5\uadf8\ub808\uc774\ub4dc \ub0a0 \ub2e4\uc2dc \uc6d0\ubb38\uc744 \ud655\uc778\ud558\uace0 \ub9b4\ub9ac\uc2a4 \ud0dc\uadf8\ub97c PR\uc5d0 \ub0a8\uae30\uc138\uc694.<\/p>\n
    FAQ<\/h2>\n
    Nuxt 4.6.2\ub294 \uc9c0\uae08 \ubc14\ub85c production\uc5d0 \uc62c\ub824\ub3c4 \ub418\ub098\uc694?<\/h3>\n
    \uba3c\uc800 preview\uc5d0\uc11c SSR \ud5e4\ub354, routeRules, \ub3d9\uc801 API \ud30c\ub77c\ubbf8\ud130, \ub300\ud45c \ud398\uc774\uc9c0\uc758 hydration\uc744 \ud655\uc778\ud55c \ub4a4 \uc62c\ub9ac\uc138\uc694. patch\ub77c\ub3c4 \uc790\uccb4 \ubaa8\ub4c8\uacfc CDN \uc870\ud569\uc758 \ud68c\uadc0 \uac00\ub2a5\uc131\uc740 \ub0a8\uc2b5\ub2c8\ub2e4. \ub2e4\ub9cc \ubcf4\uc548 \uad8c\uace0\uc5d0 \ud574\ub2f9\ud558\ub294 \uad6c\ubc84\uc804\uc774\ub77c\uba74 \ud14c\uc2a4\ud2b8 \ucc3d\uc744 \uc9e7\uac8c \uc7a1\ub418 \uc5c5\uadf8\ub808\uc774\ub4dc\ub97c \ubbf8\ub8e8\uc9c0 \uc54a\ub294 \ud3b8\uc774 \ub0ab\uc2b5\ub2c8\ub2e4.<\/p>\n
    Nuxt routeRules \ub300\uc18c\ubb38\uc790 \uc218\uc815\uc774 \ubcf4\uc548 \ubb38\uc81c\ub97c \ud574\uacb0\ud558\ub098\uc694?<\/h3>\n
    \ub2e8\ub3c5 \ud574\uacb0\ucc45\uc740 \uc544\ub2d9\ub2c8\ub2e4. 4.6.2\uc758 \ub9e4\uce6d \uc218\uc815\uc740 \ud55c \uce35\uc758 \ub3d9\uc791\uc744 \ubcf4\uc644\ud569\ub2c8\ub2e4. \ud504\ub85d\uc2dc\u00b7CDN\u00b7WAF\u00b7\uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc774 \uac19\uc740 URL \uc815\uaddc\ud654 \uaddc\uce59\uc744 \uc4f0\ub294\uc9c0, \uc778\uc99d\uacfc \uce90\uc2dc\uac00 handler\uc5d0\uc11c\ub3c4 \ub2e4\uc2dc \uac80\uc99d\ub418\ub294\uc9c0\ub97c \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n
    Nuxt 4\uc5d0\uc11c nuxt\/server\ub85c \ubaa8\ub450 \uc62e\uaca8\uc57c Nuxt 5\uc5d0 \uac08 \uc218 \uc788\ub098\uc694?<\/h3>\n
    \uc544\ub2d9\ub2c8\ub2e4. Nuxt 4.6 \ubc1c\ud45c\uc740 \uc774\ud589\uc744 \uc694\uad6c\ud558\uc9c0 \uc54a\ub294\ub2e4\uace0 \uc124\uba85\ud569\ub2c8\ub2e4. \ub2e4\ub9cc \uc0c8 server\/api \ucf54\ub4dc\uc640 \ubaa8\ub4c8\uc740 nuxt\/server<\/code>\ub97c \uc6b0\uc120 \uac80\ud1a0\ud558\uba74 Nitro\u00b7H3 major \ubcc0\ud654\uc640\uc758 \uacb0\ud569\uc744 \uc904\uc77c \uc218 \uc788\uc2b5\ub2c8\ub2e4. helper\uc758 \ubc18\ud658\uac12\uacfc \ud5e4\ub354 API \ucc28\uc774\ub294 \ubc18\ub4dc\uc2dc \ud14c\uc2a4\ud2b8\ud558\uc138\uc694.<\/p>\n
    \ucd9c\ucc98 \ubc0f \ucd94\uac00 \uc77d\uae30<\/h2>\n