除錯排查方法論

定義

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

關鍵數據點（附來源）

• Vercel Deployment Blocked 排查：經歷 5 個假設、4 次失敗嘗試，最終在第 6 次找到根因（Login Connections）。整個過程花約一小時。（vercel-deployment-blocked-troubleshoot）
• Cloudflare Pages 部署失敗：錯誤訊息不明確（「an internal error occurred」），根因是 Node.js 版本不符。（cloudflare-pages-preview-access）
• 網站速度排查：TBT 0ms 與 CLS 0 這兩個「陰性結果」一次排除 JavaScript 執行與版面兩整類原因，再用 Root document 80ms 排除伺服器，剩下的只可能是載入。（lighthouse-cli-website-speed-diagnosis）

前提與局限性

• 需要對系統有足夠理解才能提出有效假設。
• 錯誤訊息品質直接影響排查效率。
• 時間壓力可能導致跳過系統性排查、直接亂試。
• 排除法要有效，前提是量測工具本身可信；lab data 的變異會讓邊界值的判讀失準。

衝突標記

（無）

關聯概念

• [[部署平台帳號綁定]]
• [[Cloudflare Pages]]
• [[Vercel]]
• [[關鍵渲染路徑]]
• [[WordPress 效能最佳化]]