WordPress 外掛更新 Smoke Test 清單｜更新後 15 分鐘巡檢模板

WordPress 外掛更新最麻煩的地方，不是按下「更新」本身，而是更新後要在很短時間內判斷：網站還能不能被正常使用？首頁是否破版？表單有沒有送出？快取是否還在服務舊檔案？SEO metadata 是否被外掛改掉？

這篇把 UCAMC 的網站維護筆記整理成一份 15 分鐘 Smoke Test 清單。它不是完整 QA，而是更新後第一時間要跑完的最低限度驗收，目標是快速回答三個問題：

讀者還能不能順利看到主要內容？
站長還能不能登入、發文、回滾？
是否留下足夠證據，讓下一個人知道這次更新安全或需要處理？

適用情境

這份清單適合用在以下狀況：

更新 WordPress core、theme 或外掛後。
啟用、停用或替換快取 / SEO / 表單 / 安全性外掛後。
從 staging 推到 production 後。
客戶或同事回報「網站怪怪的」但還沒有明確錯誤時。
需要把維護結果交給 AI Agent 或下一位維護者接手時。

如果網站有購物車、會員系統或付費課程，這份清單仍然只能當作「第一層」Smoke Test；正式上線前仍應有更完整的流程測試。

更新前先留下基準線

不要等更新後才開始找證據。每次外掛更新前，至少先記錄：

檢查項目	更新前要留下的證據
外掛清單	版本號、預計更新項目、是否有重大版本跳號
首頁	桌機與手機截圖各一張
主要頁面	Blog、服務頁、聯絡頁或重要 landing page URL
表單 / CTA	表單名稱、測試收件信箱、按鈕位置
備份狀態	備份時間、備份工具、是否可下載或還原
快取狀態	CDN / Page Cache / Object Cache 是否開啟

小提醒：若更新前沒有基準線，更新後看到的每個差異都會變成猜測。維護記錄的價值，就是把「我覺得正常」改成「我有證據」。

15 分鐘 Smoke Test 流程

1. 首頁與主要入口

更新後先檢查讀者最容易到達的頁面：

首頁可正常載入，沒有白畫面或明顯 500 / 503。
Header、Logo、主選單、Footer 沒有錯位。
手機寬度下沒有水平捲動。
Hero CTA 可以點擊，目的地正確。
首頁最新文章、產品或服務區塊沒有顯示 shortcode、PHP warning 或 placeholder。

如果首頁有 cache，請用無痕視窗或加上 cache-busting query，例如 ?check=20260718，避免只看到自己登入狀態下的畫面。

2. 內容頁與 SEO metadata

外掛更新常常會影響 SEO plugin、schema、社群圖或 canonical URL。抽查一篇代表性文章或頁面：

Title 與 meta description 仍然合理。
canonical 指向正式網址，沒有跑到 staging 或 localhost。
Open Graph 圖片仍可載入。
文章內圖片沒有大量破圖。
麵包屑、目錄、相關文章等外掛區塊沒有重複顯示。

對內容站來說，這一段尤其重要。網站「看起來還在」不代表搜尋結果與社群分享沒有受影響。

3. 表單、登入與管理流程

如果網站有聯絡表單、訂閱表單、會員登入或後台編輯流程，至少做一次最短路徑測試：

聯絡表單可以送出，且成功訊息清楚。
收件信箱或 CRM 有收到測試資料。
WordPress 後台可以登入。
新增 / 編輯文章畫面可打開，不會卡在編輯器載入。
媒體庫可以看到圖片縮圖，沒有權限錯誤。

測試資料可使用固定格式，例如：Smoke Test - 2026-07-18 - plugin update。這樣日後搜尋 email 或 CRM log 時會更容易對上維護紀錄。

4. 快取、CDN 與前端資源

很多更新後的異常不是程式壞掉，而是 cache 混用了新舊資源：

清除 WordPress page cache。
若有 CDN，確認是否需要 purge。
隨機抽查一個 CSS / JS 版本是否回應 200。
手機與桌機至少各刷新一次。
若有登入與未登入畫面差異，兩種狀態都要看。

遇到「登入時正常、訪客看到破版」時，優先懷疑快取層，而不是直接改版面 CSS。

5. 回滾條件

Smoke Test 不是為了證明更新一定成功，而是要早點知道何時應該回滾。建議事先定義：

首頁、登入、結帳、表單任何一項不可用 → 立即回滾。
SEO canonical 大量錯誤或 Open Graph 圖片消失 → 停止後續更新，先修復。
只有次要樣式問題 → 記錄問題、截圖、建立後續修復事項。
無法判斷影響範圍 → 保留現狀，通知 Leon 或負責人決策。

可複製的維護記錄模板

# WordPress 外掛更新 Smoke Test

- 日期：
- 維護者：
- 更新項目：
- 備份時間：
- 測試環境：production / staging

## 更新前證據
- 首頁截圖：
- 代表頁 URL：
- 外掛版本：

## 更新後 15 分鐘檢查
- 首頁：OK / Fail / 說明
- Blog / 內容頁：OK / Fail / 說明
- 表單：OK / Fail / 不適用
- 登入與後台：OK / Fail / 說明
- SEO metadata：OK / Fail / 說明
- 快取 / CDN：OK / Fail / 說明

## 決策
- 保持上線 / 回滾 / 需要人工確認
- 後續修復事項：

給 AI Agent 的巡檢 Prompt

如果把這段工作交給 AI Agent，可以用更明確的任務描述：

請檢查這個 WordPress 網站在外掛更新後是否仍可正常使用。
請至少檢查：
- 首頁、Blog 列表、代表性文章
- 聯絡表單、登入頁
- robots.txt、sitemap.xml、canonical
- Open Graph 圖片與手機版水平 overflow
請列出每個 URL 的 status code、錯誤訊息、是否需要回滾，
以及需要人工決策的項目。
不要修改正式環境設定或機密；若需要帳密或 token，請列為人工處理。

UCAMC 的做法

UCAMC 目前把舊 WordPress Blog 逐步整理成 Next.js Markdown 內容站；但 WordPress 經驗仍然很重要，因為許多內容品牌和客戶網站仍以 WordPress 為核心營運工具。

因此，這類 Smoke Test 清單會被當成「內容」與「維護流程」兩種資產：

對讀者來說，它是一份可收藏、可複製的網站維護模板。
對 UCAMC 來說，它是未來 AI Agent 維護網站時可重複執行的標準流程。
對舊文章整理來說，它也能把零散 WordPress 維護經驗變成更長期可搜尋的知識庫。

重點不是把每次更新做得很複雜，而是讓每次維護都能留下足夠清楚的證據：更新了什麼、檢查了什麼、哪裡安全、哪裡需要回滾。這就是長期經營內容站時最實用的技術債管理方式。

WordPress 外掛更新 Smoke Test 清單：更新後 15 分鐘內要檢查什麼