測試與發佈流程故障排查:從現象到根因

發佈故障裡最常見的是“改動不生效”,八成是快取或權限問題,而不是程式碼沒傳上去。

資訊中心:測試與發佈流程故障排查:從現象到根因

四類故障

現象 常見根因
改動不生效 快取未清、檔案未覆蓋
全站報錯 依賴缺失、設定錯誤
部分頁面異常 路徑或權限問題
復原失敗 備份不全、資料庫不可逆

一、改動不生效

排查順序:

  1. 確認檔案確實已上傳(看修改時間與大小)。
  2. 清頁面快取與範本快取。
  3. 檢查是否有 OPcache。
  4. 確認訪問的是目標環境。

二、全站報錯

  • 檢視錯誤日誌首條記錄。
  • 檢查依賴是否安裝完整。
  • 檢查設定檔案是否被覆蓋(尤其環境設定)。
  • 檢查目錄權限。

三、部分頁面異常

  • 是否爲新增頁面(路由或重寫規則未更新)。
  • 是否爲上傳目錄(權限不足)。
  • 是否有大小寫敏感問題。

四、復原失敗

  • 備份是否包含本次全部變更檔案。
  • 資料庫變更是否可逆。
  • 復原後是否清快取。

復原失敗通常意味着“發佈前準備不足”,而非復原本身有問題。

一張排查表

現象 第一步
不生效 查檔案與快取
全站報錯 查日誌首條
部分異常 查路徑與權限
復原失敗 查備份完整性

預防措施

  • 發佈指令碼內置清快取步驟。
  • 備份包含變更清單。
  • 資料庫變更事先寫好復原語句。
  • 發佈後固定冒煙五項。

邊界

本文按傳統檔案部署整理。容器化部署的排查路徑不同,需結合映像與設定管理。

相關閱讀: