除錯排查方法論

定義

在遇到技術問題時，系統性地縮小問題範圍、驗證假設、找到根因的思考流程。核心原則：每次只改一個變數、先排除最可能的原因、記錄每次嘗試的結果。

關鍵數據點（附來源）

• Vercel Deployment Blocked 排查：經歷 5 個假設、4 次失敗嘗試，最終在第 6 次找到根因（Login Connections）。整個過程花約一小時。（vercel-deployment-blocked-troubleshoot）
• Cloudflare Pages 部署失敗：錯誤訊息不明確（「an internal error occurred」），根因是 Node.js 版本不符。（cloudflare-pages-preview-access）

前提與局限性

• 需要對系統有足夠理解才能提出有效假設。
• 錯誤訊息品質直接影響排查效率。
• 時間壓力可能導致跳過系統性排查、直接亂試。

衝突標記

（無）

關聯概念

• [[部署平台帳號綁定]]
• [[Cloudflare Pages]]
• [[Vercel]]