部署成功但網頁不顯示

Cloudflare Pages 免費方案 — 檔案數量上限問題排查

06 · Cloudflare Pages 故障排除
← 返回重要備忘
❓ 問題現象

⚠️ wrangler 部署回報成功，但網頁仍顯示舊內容

執行 wrangler pages deploy 後看到 ✨ Deployment complete!，但瀏覽器訪問網站時，頁面內容完全沒有更新，甚至出現空白或錯誤頁面。

⚠️ 這不是 wrangler 的 bug，也不是 Token 失效，而是 Cloudflare 免費方案的檔案數量限制被觸發了。
🔬 根本原因

每次執行 wrangler pages deploy，Cloudflare 會建立一個全新的 deployment（子站），裡面包含全部的檔案。舊的 deployment 不會自動刪除，檔案會持續累積。

~48
每次部署檔案數
×
~10
部署次數
=
~480
累積檔案數
🚨 當累積檔案數超過約 500 個時，新部署會回報成功但不實際生效 — 網頁不會更新。
部署 #1 ─── 48 個檔案 ─── ✅ 生效（總計 48） 部署 #2 ─── 48 個檔案 ─── ✅ 生效（總計 96） ... 部署 #9 ─── 48 個檔案 ─── ✅ 生效（總計 432） 部署 #10 ─── 48 個檔案 ─── ❌ 超限！回報成功但不生效（總計 480+）
✅ 解決方案

手動到 Cloudflare Dashboard 刪除較早的 deployment，清出空間。

登入 Cloudflare Dashboard

左側選單點選 Workers & Pages

選擇專案 wholistics

點選 Deployments 分頁，查看所有歷史部署

找到較舊的 deployment，點選右側 ⋯ 選單 → Delete

刪除足夠多的舊部署後，重新執行 wrangler pages deploy

✅ 刪除舊 deployment 後，新部署就能正常生效。建議保留最新的 2-3 個 deployment作為回滾備用。
🛡️ 預防措施
  • 📅 定期清理：每週檢查一次 deployment 數量，刪除不需要的舊版本
  • 🔢 控制部署頻率：不要頻繁測試部署，本地先驗證再上傳
  • 👀 部署後驗證：每次部署後用 web_fetch 或瀏覽器確認網頁內容確實更新
  • 📋 記錄次數：留意累積部署次數，接近 10 次時主動清理
  • 💎 升級方案：付費方案無此限制，若頻繁部署可考慮升級
⚡ 快速判斷流程
wrangler 部署回報 ✨ Success! │ ├── 瀏覽器開啟網站 │ │ │ ├── 內容已更新 → ✅ 正常，無需處理 │ │ │ └── 內容未更新 → ❓ 可能觸發檔案上限 │ │ │ ├── 嘗試清除瀏覽器快取後重試 │ │ │ │ │ ├── 清快取後正常 → ✅ 只是快取問題 │ │ │ │ │ └── 仍顯示舊內容 → 🚨 檔案上限！去 Dashboard 刪舊 deployment │ │ │ └── 檢查 Dashboard Deployments 數量 │ │ │ ├── 超過 10 個 deployment → 刪除舊的 │ │ │ └── 不多但仍有問題 → 檢查 Token、Account ID 等設定
📎 相關備忘