Day 13:第二篇:以為部署成功,其實在騙自己
本篇記錄了一次看似成功的部署,實則因遠端建置問題導致線上內容未更新的除錯經驗。作者在部署一個小功能後,發現線上環境抓不到新字串,從最初懷疑CDN快取,逐步排除了快取、CDN層級問題,最終定位到Vercel遠端建置本身產出舊內容的錯誤。透過本機建置並直接部署的方式解決,並將內容比對機制納入部署流程,強調驗證的重要性,適合開發者與DevOps工程師參考。
重點摘要
- 一個看似簡單的功能修正,部署後卻發現線上內容未更新。
- 初步懷疑是CDN快取問題,但深入追查後發現並非快取造成。
- 即使強制部署或繞過CDN直連伺服器,線上內容依然是舊版本。
- 問題最終被定位為Vercel遠端建置過程產生了錯誤的舊內容,且檔名雜湊與正確內容相同。
- 解決方法是改用本機建置後直接部署,繞過遠端建置的潛在問題。
- 為防止類似問題再次發生,作者將線上與本機建置內容的checksum比對納入部署流程。
- 強調「READY」僅是狀態,而非內容正確的證明,驗證流程需更實質的內容比對。
章節
小修正與部署後的初步驗證
作者為網站新增點擊展開功能,部署後依慣例驗證線上內容,準備確認新字串是否存在。
第一個不對勁:抓不到新字串
部署後curl線上chunk抓不到新字串,初步懷疑是CDN快取問題,但對雜湊檔名與內容不符產生疑問。
追查真相:排除快取問題
透過強制部署、繞過CDN直連Vercel伺服器等方式,確認問題並非快取,而是Vercel遠端建置產出舊內容。
真正的修法:本機建置與部署
放棄遠端建置,改用本機建置後直接部署,成功讓線上內容更新,並確認檔名雜湊也隨之改變。
流程改進:將驗證鎖進腳本
為避免重蹈覆轍,作者修改部署腳本,加入本機與線上chunk的checksum比對機制,確保內容一致性。
核心教訓:驗證的實質意義
總結經驗,強調部署成功狀態不等於內容正確,實質的內容驗證才是關鍵。
適合對象:軟體開發者、DevOps工程師、系統維運人員,特別是使用Vercel等雲端部署服務的技術人員。