從 0 建設個人網站
本機正常,部署就失敗?2026 網站部署失敗的常見原因與排查順序
本機正常,推上 Vercel、Cloudflare 或 Netlify 就建置失敗?先分清是建置還是執行出錯,讀建置紀錄、乾淨環境重現,再對照常見原因和實際案例。
Kelvin Wang · · 19 分鐘閱讀
重點整理
- 先分清楚是哪一種壞法:沒有觸發建置、建置失敗、建置成功但線上壞掉,三種查法完全不同。
- 建置紀錄要找第一個錯誤,不是最後一行;最後一行通常只是「指令結束,代碼 1」。
- 本機能跑的最大原因是本機多了東西:.env、快取、不分大小寫的檔案系統、不同版本的 Node。用乾淨的 clone 跑 npm ci && npm run build,最接近雲端建置機器的環境。
- 請 AI 修部署時,給它完整的錯誤紀錄,要它先重現、說出原因再改;不要接受關掉檢查、加 --force 或刪測試這類修法。
你在自己電腦上跑 npm run dev,一切正常;推到 GitHub、部署平台開始建置,結果紅字失敗。或者建置顯示成功,打開網站卻是空白、少了樣式、重新整理變 404。原因幾乎都是同一件事:部署平台的建置機器和執行環境,跟你的電腦不一樣。不管你是用 Claude Code、Cursor、v0 還是 Lovable 寫的網站,不管部署到哪一家,查法都一樣。
我的網站是 Astro,跑在 Cloudflare Workers,用 Claude Code 協助寫。下面這些原因,從 2026 年 9 月到現在我遇過七次,每一次都對得到 repo 裡的 commit。
本機和部署平台到底差在哪?
部署平台在它自己的機器上,從 GitHub 抓一份乾淨的程式碼,重新安裝套件、跑一次建置。你電腦上有、但沒有進 git 的東西,它都沒有。幾乎所有「本機正常、部署失敗」,都出在下面這幾項差異:
| 差異 | 你的電腦 | 部署平台的建置機器 |
|---|---|---|
| 環境變數 | .env 檔案裡都有 | .env 不進 git,平台上沒設就是沒有 |
| 檔名大小寫 | macOS、Windows 預設不分大小寫 | Linux,Header.js 和 header.js 是兩個檔案 |
| Node 版本 | 你自己裝的那一版 | 平台的預設版本,或你指定的版本 |
| 套件 | node_modules 可能是很久以前裝的 | 照 lockfile 重新安裝 |
| 快取 | 之前建置留下的快取 | 通常是空的,或平台自己的建置快取 |
| 資源 | 記憶體、開檔數通常很寬 | 有上限,超過就失敗或被中止 |
| 執行環境 | Node.js | 可能是 Node.js,也可能是 Workers、Edge 這類精簡的執行環境 |
Vercel 的官方指南把最常見的 Module not found 歸因到大小寫:Windows 和 macOS 的檔案系統預設不分大小寫,Vercel 的建置是在分大小寫的 Linux 檔案系統上跑4。Netlify 的文件也寫了同一件事,還提醒產生的錯誤訊息不一定看得出是大小寫問題3。
先分清楚:是哪一種部署失敗?
「部署失敗」其實有三種,查法完全不同。先確定你遇到的是哪一種:
| 症狀 | 是哪一種 | 先看哪裡 |
|---|---|---|
| push 之後平台上沒有新的部署紀錄 | 沒有觸發建置 | 平台和 GitHub 的連線、要部署的分支設定 |
| 部署紀錄是紅色的、顯示 Failed | 建置失敗,線上還是舊版 | 建置紀錄(build log) |
| 部署成功,網站打得開但內容不對、空白、少樣式、某些頁 404 | 建置成功,執行時壞掉 | 瀏覽器開發者工具的 Console 和 Network,以及平台的執行期 log |
建置失敗時,網站不會壞,平台會繼續跑上一個成功的版本。所以「網站還打得開」不代表新版本上線了。細節和每次 push 後怎麼確認,寫在另一篇:
想深入 AI 寫的網站上線後會壞在哪?部署失敗、憑證外洩與資料庫權限 部署失敗時線上停在舊版、怎麼確認真的上線、壞了怎麼退回。建議照這個順序查:
- 確認有沒有建置。平台的部署列表裡沒有這次 commit,就是沒觸發;這時重新觸發是對的,因為根本沒有 log 可讀。
- 建置失敗就讀建置紀錄,找第一個錯誤(下一節)。
- 在乾淨的環境重現。另外 clone 一份 repo,不放
.env,用跟平台一樣的 Node 版本跑npm ci && npm run build。 - 重現得出來,對照下面的原因表修;重現不出來,懷疑資源限制或平台設定。
- 建置成功但線上壞掉,打開瀏覽器開發者工具看 Console 和 Network 的紅字,再看平台的執行期 log。
- 修好之後,再打開線上頁面確認一次,不要只看建置變綠。
症狀對照表
| 你看到的 | 最可能的原因 | 先做什麼 |
|---|---|---|
| push 之後沒有新的部署 | 沒觸發建置 | 檢查分支設定,重新觸發 |
建置時 undefined、Invalid URL | 建置環境沒有環境變數 | 到平台設定建置用的變數,重新部署 |
Module not found,檔案明明在 | 檔名大小寫 | 比對 import 和實際檔名,用 git mv 改名 |
Unsupported engine、語法錯誤 | Node 版本不同 | 用 .nvmrc 或平台設定指定版本 |
npm ci 說 lockfile 不同步 | 改了 package.json 沒更新 lockfile | 本機 npm install,lockfile 一起 commit |
| 建置成功,網站 404 或空白 | 輸出資料夾或建置指令設錯 | 對照框架的輸出資料夾 |
時好時壞,EMFILE、out of memory | 建置機器資源上限 | 讀 log,減少同時開檔或記憶體用量 |
Console 顯示某個變數是 undefined | 變數沒有進瀏覽器的前綴 | 確認前綴,而且變數不是機密 |
| 請求打到 localhost | 網址寫死 | 改成環境變數或相對路徑 |
| 某些頁面一執行就 500 | 執行環境不支援某個 Node API | 看執行期 log,用平台的本機模擬重現 |
| 重新整理就 404 | SPA 沒設改寫規則 | 加 rewrite 或 not_found_handling |
| CSS、JS 全部 404 | base path 沒設 | 設 base 或 basePath |
Console 有 Mixed Content | HTTPS 頁面載入 HTTP 資源 | 網址改成 https |
| 剛部署完沒有樣式,過一陣子好了 | 快取送舊 HTML | 查 CDN 或自己的快取設定 |
建置紀錄怎麼讀?
每一家的建置紀錄放在不同地方:
| 平台 | 建置紀錄在哪 |
|---|---|
| Vercel | 專案 → Deployments → 點失敗的那次部署 → Deployment Details 裡展開 Building [1] |
| Cloudflare Workers | Workers & Pages → 選 Worker → Deployments → View build history [2];GitHub commit 旁邊的 check run 也會顯示成敗 |
| Netlify | 每次部署的 deploy log,記錄建置和部署的每一步和錯誤 [3] |
| GitHub Pages | repo 的 Actions 分頁,那次部署的 workflow run;從分支發布和自訂 workflow 都會產生 workflow run [22] |
讀的方法是同一套:
- 找第一個紅色的
Error、ERR!或error,不是最後一行。Vercel 的文件舉的例子就是這樣:最後一行只寫yarn run build exited with 1,真正的原因在往上幾行1。 - 看它在哪個階段:安裝套件(install)、建置(build)、還是上傳部署(deploy)。安裝階段失敗多半是 lockfile 或 Node 版本;建置階段多半是程式、環境變數或大小寫;部署階段多半是平台設定。
- 把那一段前後二、三十行整段複製下來,之後給 AI 或自己搜尋都用這段。
Vercel 也提醒,有些情況建置根本沒開始,例如 vercel.json 格式錯誤,這時沒有建置紀錄,錯誤直接顯示在畫面上1。
建置失敗最常見的原因
建置時讀不到環境變數
症狀:建置在抓資料的那一步失敗,錯誤裡有 undefined、Invalid URL、supabaseUrl is required 這類字,或某個 API 回 401。
本機有 .env,建置機器沒有。你要到平台後台把變數一個一個填進去。容易漏的地方有兩個:
- 建置時和執行時是兩組變數。有些平台分開設定。Cloudflare Workers Builds 的建置變數設在 Settings → Build 的 Build variables and secrets,官方文件寫明這些變數執行時讀不到,執行時用的變數要另外到 Settings → Variables & Secrets 設23。反過來,同一頁最上面那塊 Variables & Secrets 是執行期的變數,填在那裡,建置時一樣讀不到;這個位置我自己就放錯過。我的網站接上 Workers Builds 後,第一次自動建置就卡在建置變數:文章在建置時要從 Supabase 讀資料,建置環境卻沒有那兩個變數,到 Settings → Build 補上之後才建置成功。
- 改了變數要重新部署。Vercel 文件寫明,環境變數的變更只會套用到新的部署,已經在跑的部署保留建置時的值12。Vercel 也分 Production、Preview、Development 三種環境,只設在 Production 的話,預覽網址會讀不到12。
檔名大小寫不一致
症狀:Module not found、Cannot find module、Could not resolve,而你確定那個檔案存在。
程式寫 import Header from './components/Header',實際檔名是 header.astro。在 macOS 上找得到,在 Linux 上找不到。在分大小寫的磁碟上可以重現,Node 給的錯誤是:
Error [ERR_MODULE_NOT_FOUND]: Cannot find module '.../components/Header.js' imported from .../main.mjs
同一份檔案在 macOS 一般的磁碟上可以正常執行。各家打包工具的錯誤寫法不同,但意思一樣。
修法有一個陷阱:在 macOS 上直接改檔名的大小寫,git 可能看不到變更。Vercel 建議先執行 git config core.ignorecase false,或用兩次 git mv 經過一個暫時的檔名改過去4:
git mv components/header.astro components/header-tmp.astro
git mv components/header-tmp.astro components/Header.astro
Node 或套件管理工具的版本不同
症狀:安裝階段就失敗,錯誤提到 engine、Unsupported engine、語法錯誤,或某個套件要求更新的 Node。
每家平台都有預設的 Node 版本,不一定是你電腦上那一版。2026 年 11 月我查的時候,Cloudflare Workers Builds 的預設是 24.22.16,Vercel 新專案預設用它提供的最新 LTS,目前是 26.x7。指定版本的方法:
| 平台 | 怎麼指定 Node 版本 |
|---|---|
| Vercel | 專案 Settings → Build and Deployment → Node.js Version;package.json 的 engines.node 會蓋過這個設定 [7] |
| Cloudflare Workers Builds | 建置變數 NODE_VERSION,或在根目錄放 .nvmrc、.node-version [6] |
| Netlify | NODE_VERSION 環境變數,或 .node-version、.nvmrc,兩者都會蓋過後台的設定 [5] |
| GitHub Pages(Actions) | workflow 裡 setup-node 那一步指定的版本 |
先在本機跑 node -v,把同一個主版本寫進專案。套件管理工具也一樣:平台看 repo 裡的 lockfile 決定用 npm、pnpm 還是 yarn65,同一個 repo 裡同時有 package-lock.json 和 pnpm-lock.yaml 就容易出事,只留一個。
lockfile 和 package.json 對不上
症狀:
npm error `npm ci` can only install packages when your package.json and package-lock.json or npm-shrinkwrap.json are in sync. Please update your lock file with `npm install` before continuing.
改了 package.json 卻沒有更新 lockfile,再跑 npm ci,就會出現這段。有些平台和 CI 會用 npm ci 安裝(Cloudflare 的排錯文件就列了這個錯誤2),它要求 lockfile 存在,而且和 package.json 一致,不一致就直接報錯,不會幫你更新8。最常見的是 AI 在 package.json 加了套件,卻沒有跑 npm install,或跑了卻沒有把 lockfile 一起 commit。
修法:在本機跑 npm install,把更新後的 lockfile 一起 commit。如果本機跑 npm ci 沒問題、只有 Cloudflare 上失敗,Cloudflare 的排錯文件說多半是 lockfile 由比建置機器更新的 npm 產生;它不看 engines.npm,要在 package.json 的 packageManager 寫上本機 npm -v 的確切版本,例如 "packageManager": "npm@11.19.1"2。
套件之間版本不相容是另一種:Could not resolve dependency、Conflicting peer dependency。Netlify 的文件說明,npm 8.6 到 8.12.1 有一個行為會造成這種失敗,主要出現在 React 17 以上、Node 16.5.1 以上的網站,解法是用 NPM_FLAGS 環境變數加上 --force 或 --legacy-peer-deps3。這是針對那幾版 npm 的暫時解法;用在其他情況時,這兩個參數只是叫 npm 忽略衝突,衝突還在,正是後面「怎麼請 AI 修部署」要擋掉的那種修法。我遇到的那次(TypeScript 7 不在 @astrojs/check 接受的範圍內),選的是把 TypeScript 固定在 6,讓版本真的對上,而不是叫 npm 忽略衝突。
建置指令或輸出資料夾設錯
症狀:建置成功,網站卻是 404、空白,或顯示原始的檔案列表。
平台要知道兩件事:跑什麼指令建置、建置完把哪個資料夾放上線。Vercel 偵測到框架時會自動填,只有輸出資料夾裡的東西會被送出去13。偵測錯了,或專案不在 repo 根目錄,就要自己改:
- 輸出資料夾。Astro、Vite 是
dist,Next.js 靜態匯出是out。 - Root Directory。程式放在 repo 的子資料夾(例如
web/)時要設。 - Cloudflare Workers。Cloudflare 的排錯文件把「建置成功、網站 404 或空白」歸到三個原因:建置指令沒跑框架的建置、
assets.directory沒指到輸出資料夾、單頁應用沒設not_found_handling2。
建置機器資源不夠
症狀:時好時壞;錯誤是 EMFILE: too many open files、JavaScript heap out of memory、SIGKILL,或建置被中止。
雲端建置機器的記憶體、開檔數、時間都有上限。Vercel 單次建置最長 45 分鐘1,Cloudflare Workers Builds 是 20 分鐘2。我遇到的是開檔數:Rollup 預設同時開 1,000 個檔案,在我的電腦上沒事,在 Cloudflare 的建置機器上有時會超過上限(Cloudflare 沒有公布這個上限,比我的電腦低是從現象和本機重現推斷的)。在本機用 ulimit -Hn 512 壓低上限就重現了,把 maxParallelFileOps 設成 64 解決。完整的排查過程寫在 Workers 教學的「部署失敗怎麼查?」。
建置成功、網站卻壞掉的常見原因
環境變數沒進到瀏覽器,或不該進的進去了
症狀:頁面上某個功能沒反應,Console 顯示變數是 undefined。
前端框架只會把加了特定前綴的變數放進瀏覽器的程式,而且是在建置時把值直接寫進去:
| 框架 | 進瀏覽器的前綴 | 什麼時候決定值 |
|---|---|---|
| Next.js | NEXT_PUBLIC_ | next build 時寫進 JavaScript,之後改變數不會變 [9] |
| Vite(React、Vue 專案常用) | VITE_ | 建置時靜態替換 [10] |
| Astro | PUBLIC_ | 建置時靜態替換 [11] |
這會帶來兩個後果。第一,沒加前綴的變數在瀏覽器裡就是 undefined,在本機也一樣,但如果你本機剛好是從伺服器端讀,就不會發現。第二,加了前綴的變數任何訪客都看得到,Vite 文件直接寫這些變數不應該放 API 金鑰這類機密10。AI 有時會為了「讓它能動」幫你把金鑰加上前綴,這時功能是好了,金鑰也公開了。
另外,Next.js 只會替換寫成完整名稱的 process.env.NEXT_PUBLIC_XXX;用變數組出來的名稱(process.env[name])不會被替換9。
程式還連著 localhost
症狀:線上頁面的 Network 分頁裡,有請求打到 http://localhost:3000 或 127.0.0.1,失敗。
開發時 API 和資料庫都在你自己電腦上,AI 寫程式時常把 http://localhost:3000/api 直接寫死在程式裡。部署上線後,訪客的瀏覽器去連的是訪客自己電腦的 localhost,當然連不到。搜尋整個專案的 localhost 和 127.0.0.1,改成環境變數,或改成相對路徑(/api/...)。
執行環境不是 Node.js
症狀:建置成功,某些頁面或 API 一執行就 500;log 提到某個模組找不到、某個 API 不支援,或像我遇到的 Invalid redirect value。
Vercel 的 Edge、Cloudflare Workers 這類執行環境不是完整的 Node.js。Next.js 文件寫明,Edge Runtime 不支援所有 Node.js API,例如不能讀寫檔案系統,也不能直接呼叫 require15。Cloudflare Workers 要用 Node.js 的 API,得開 nodejs_compat;2026-08-04 以後的相容日期預設就開,之前的要自己加16。
這類問題最麻煩的地方是本機測試抓不到,因為測試在 Node 上跑。我的 OAuth 那次就是:所有測試都過,上線後每一次登入社群帳號的請求都失敗。修好之後加了一個測試,直接檢查原始碼裡不能再出現 redirect: 'error'。本機要更接近線上,用平台提供的本機模擬,例如 Cloudflare 的 wrangler dev,或 Vercel 的 vercel dev。
Next.js 放上 Cloudflare 時的轉接工具也會影響這件事:next-on-pages 只支援 Edge runtime,2026 年 10 月已經封存。我 2023 年把一個 Next.js 專案從 13 升到 14,就因為它還不支援新版被卡過:
想深入 Next.js 部署到 Cloudflare 2026:next-on-pages 停止維護後,升級該怎麼走 next-on-pages 封存後的三條路:vinext、OpenNext、靜態匯出。首頁正常,重新整理其他頁就 404
症狀:從首頁點進 /about 正常;在 /about 按重新整理或直接貼網址,就是 404。
這是單頁應用(SPA)的典型問題,用 React、Vue 加前端路由做的網站常遇到。點連結時是瀏覽器裡的 JavaScript 在換畫面;重新整理時,瀏覽器真的去主機要 /about 這個檔案,主機上只有 index.html,所以 404。修法是告訴主機「找不到的路徑都送 index.html」:
| 平台 | 設定 |
|---|---|
| Vercel | vercel.json 加 "rewrites": [{ "source": "/(.*)", "destination": "/index.html" }] [19] |
| Cloudflare Workers | wrangler.jsonc 的 assets 加 "not_found_handling": "single-page-application";wrangler.toml 寫成 not_found_handling = "single-page-application" [17] |
| Netlify | _redirects 檔案寫 /* /index.html 200,通常放最後一條 [18] |
| GitHub Pages | 沒有改寫規則的設定。可以把 index.html 複製一份成 404.html [20],頁面會正常顯示,但狀態碼仍是 404;或改用 hash 路由(/#/about) |
如果你的網站主要是文章和介紹頁,更根本的做法是改用會把每一頁都產生成 HTML 的框架,搜尋引擎也比較好讀。
網址前綴(base path)不對
症狀:部署到 https://帳號.github.io/repo名稱/,頁面打得開但 CSS、JS、圖片全部 404。
網站不是放在網域的根目錄,而是在一個子路徑底下時,框架要知道這個前綴,不然它會去 /assets/... 找檔案,實際檔案在 /repo名稱/assets/...。GitHub Pages 的專案網站就是這種情況,Vite 文件說這時 base 要設成 '/<REPO>/'14;Astro 的設定叫 base,Next.js 叫 basePath。用自訂網域或 帳號.github.io 這種根目錄網站就不需要。
HTTPS 頁面載入 HTTP 的資源
症狀:Console 有 Mixed Content 警告,某支外部 script、某個 API 呼叫被擋,或頁面少了樣式、字型變回預設。
上線的網站是 HTTPS,程式裡卻有 http:// 開頭的網址,這叫混合內容。瀏覽器會把圖片這類資源自動升級成 HTTPS;script、fetch()、用 <link> 載入的樣式表和網頁字型會被直接擋掉21,所以外部 CSS 或字型用 http:// 引入時,頁面就會少樣式。本機用 http://localhost 開發時沒有這個問題,所以只有上線才看得到。把網址改成 https://,對方不支援 HTTPS 的話就要換服務,或由你的伺服器代為請求。
部署後一段時間樣式不見
症狀:剛部署完,有些人看到沒有樣式的頁面,或 Console 有 Uncaught SyntaxError: Unexpected token;過一陣子自己好了。
建置工具會在 CSS、JS 的檔名加上雜湊(例如 index.a1b2c3.js),每次建置都換名字。如果有一層快取還在送舊版本的 HTML,舊 HTML 引用的舊檔名在新部署裡已經不存在。Netlify 文件把 Unexpected token 這類錯誤歸到同一個原因:引用了已經不在的資源,常見於有雜湊檔名或程式碼分割的網站3。我的網站是自己在 Worker 裡做的快取造成的,修法是把建置編號放進快取的 key,新部署一上線就不會再拿到舊 HTML。
怎麼請 AI 修部署,才不會越修越糟?
AI 很會讀錯誤紀錄,但它看不到你的部署平台後台,也不知道平台用的 Node 版本。給的資訊不夠,它就會猜,猜錯就會開始改一些不相干的東西。請 AI 修部署時,照這個順序給它資訊:
- 給它完整的那一段錯誤,前後二、三十行,不要只貼最後一行,也不要用自己的話轉述。
- 告訴它環境:哪個平台、哪個 Node 版本、建置指令是什麼、本機能不能建置成功。
- 要它先重現,再說出原因。例如「在乾淨的 clone 裡不放
.env跑npm ci && npm run build」,重現得出來才動手改。 - 限制修改範圍:一次只修這個錯誤,不要順便升級套件、改架構。
- 修好後要它加一個檢查,防止同一個問題再出現。我的 EMFILE 修法是一行設定,另外加了一個測試,那一行被拿掉或數字被改到超過 128,測試就失敗。
- 最後自己打開線上頁面確認,不要只聽它說「已修好」。
要特別小心下面幾種「修法」,錯誤訊息消失了,問題卻還在:
- 關掉檢查。把 TypeScript 或 lint 的錯誤設成忽略、跳過測試。
- 強制安裝。
--force、--legacy-peer-deps可以讓安裝過關,但版本衝突還在,之後可能在別的地方壞。 - 刪掉或改掉失敗的測試,讓它變綠。
- 把機密加上公開前綴,讓前端讀得到。
- 一直重新部署,期待下次會成功。
我在網站的專案說明檔(我用 CLAUDE.md;Codex、Cursor 等工具讀 AGENTS.md 或自己的專案規則)寫了部署方式(push 到 main 就部署)和手動部署的備案,AI 一進專案就知道 push 等於上線,也知道該去哪裡確認。
我自己遇過的 7 次
- 造成損害
- 警示或服務縮減
-
警示或服務縮減: 2026-09-26
npm ci安裝失敗TypeScript 7 不在
@astrojs/check接受的範圍內,固定在^6解決(commit8606f87)。 -
造成損害: 2026-09-29
接上 Workers Builds,第一次自動建置就失敗
建置環境沒有 Supabase 的建置變數。補上之後,在 README 記下建置需要這兩個變數(commit
f5840c1)。 -
警示或服務縮減: 2026-10-06
一個套件差點在 Workers 上載入不了
加入
twitter-text時,它引用的punycode會被當成 Node 內建模組,Cloudflare 的執行環境載入不了,所以加了 alias 指到 npm 套件(commit354068c)。 -
造成損害: 2026-10-08
測試全過,線上的 OAuth 全部失敗
Workers 不接受
fetch的redirect: 'error'(commit1bca515)。 -
警示或服務縮減: 2026-10-25
部署後一段時間頁面沒有樣式
自己做的邊緣快取送舊版 HTML,最多持續 15 分鐘(commit
f8f3953)。 -
警示或服務縮減: 2026-10-30
push 之後根本沒有觸發建置
推一個空 commit 重新觸發(commit
51eeb63)。 -
造成損害: 2026-11-05
7 次 push 有 5 次建置失敗
EMFILE: too many open files,限制 Rollup 同時開檔數後解決(commit44ec11e)。
常見問題
本機 npm run dev 正常,代表部署一定沒問題嗎?
不代表。dev 模式和正式建置走的是不同流程,很多錯誤只在建置時出現。部署前至少在本機跑一次 npm run build,再用框架的 preview 指令看建置結果;Vite 文件也提醒 vite preview 只是在本機預覽建置結果,不是正式的伺服器14。
改了環境變數,網站沒變?
大部分平台要重新部署才會生效,在瀏覽器裡用的變數更是建置時就寫死了。改完變數,到平台觸發一次新的部署。
建置一直失敗,可以先退回上一版嗎?
建置失敗時,線上本來就還是上一個成功的版本,不用退回。要退回的是「建置成功但新版本壞掉」的情況。Cloudflare Workers 怎麼退回、有哪些限制,寫在〈AI 寫的網站上線後會壞在哪?〉;其他平台以各自後台的部署列表為準。
資料來源
- 1. Troubleshooting Build Errors
- 2. Troubleshooting builds
- 3. Build troubleshooting tips
- 4. How do I resolve a 'module not found' error?
- 5. Manage build dependencies
- 6. Build image
- 7. Supported Node.js versions
- 8. npm ci
- 9. How to use environment variables in Next.js
- 10. Env Variables and Modes
- 11. Using environment variables
- 12. Environment variables
- 13. Configuring a Build
- 14. Deploying a Static Site
- 15. Edge Runtime
- 16. Node.js compatibility
- 17. Single Page Application (SPA)
- 18. Rewrites and proxies
- 19. Static Configuration with vercel.json
- 20. Creating a custom 404 page for your GitHub Pages site
- 21. Mixed content
- 22. Configuring a publishing source for your GitHub Pages site
- 23. Configuration