WordPress 課程網站功能很多，LMS、WooCommerce、會員、金流、Email、快取、資安與頁面編輯器常會同時運作。網站如果在更新後突然白畫面、結帳異常、登入失敗或課程權限錯亂，外掛衝突是其中一個可能原因，但不要一看到錯誤就把所有外掛全部關掉。
第 1 步：先記錄「什麼時候開始壞」
時間點是最有價值的線索。先回想錯誤發生前是否做過更新、安裝新外掛、改 PHP 版本、調整快取、安全規則或金流設定。
- 哪一個頁面出錯？
- 只有管理員還是所有訪客？
- 手機和電腦都會發生嗎？
- 登入後才出錯，還是公開頁也壞？
- 最近更新了哪些外掛？
不要先急著改設定。能清楚描述錯誤，後面的測試才知道「問題真的好了」還是只是暫時看不到。
第 2 步：先備份，再開始排錯
外掛衝突排查可能需要停用、更新、降版或切換佈景主題，開始前應先有可還原的備份。課程網站還有訂單與會員資料，如果排錯時間較長，也要注意備份與正式站資料是否產生落差。
完整備份做法可以搭配課程網站備份與還原一起看。
第 3 步：先看錯誤 log 與網站健康狀態
如果有 PHP fatal error、WooCommerce log、金流錯誤或主機記錄，先看紀錄通常比盲目停外掛更快。錯誤訊息可能直接指出某個外掛路徑、函式或版本。
WordPress 的網站健康工具也能協助發現 PHP、REST API、更新與其他環境問題。錯誤不一定是外掛彼此衝突，也可能是伺服器環境或版本不符。
第 4 步：優先在 staging 測試站重現
正式課程網站有真實學員與訂單，不適合直接把所有外掛停掉。比較安全的方式是複製一份測試站，在測試站重現問題，再進行停用與切換。
如果沒有 staging，也可以使用 WordPress 社群提供的 Troubleshooting Mode 類工具，讓「只有管理員自己的工作階段」暫時停用外掛與切換預設佈景主題，不影響一般訪客看到的正式網站。實際操作前仍建議備份。
第 5 步：保留必要外掛，再逐步啟用
標準測試方式是先建立最小環境，再一個一個加回功能。例如付款問題可以先保留 WooCommerce 與金流外掛；課程權限問題可以保留 LMS 與必要整合。
- 確認最小環境是否仍會出錯。
- 如果問題消失，逐一啟用外掛。
- 每啟用一個就重測同一個錯誤情境。
- 問題重新出現時，記錄最後加入的外掛。
- 再測兩個外掛是否真的只有一起啟用才出錯。
一次啟用五個外掛雖然比較快，但問題回來時還是不知道是哪一個，反而要重做。
第 6 步：確認是外掛版本、設定還是佈景主題
找到疑似外掛後，不代表外掛本身一定有 bug。可能是特定設定、舊版程式、PHP 版本，或和目前佈景主題／另一個外掛一起使用才發生。
- 外掛是否為最新版？
- WordPress／WooCommerce 是否在支援版本？
- PHP 版本是否符合需求？
- 切換預設佈景主題後是否正常？
- 清除快取後錯誤是否仍存在？
第 7 步：修好後做完整回歸測試
課程網站不能只確認「原本那個錯誤消失」。外掛設定調整後，要重新測整個核心流程，避免修了付款卻壞了會員，或修了版面卻讓通知信失效。
- 首頁與主要銷售頁。
- 註冊／登入。
- 結帳與付款。
- 付款後自動開課。
- 會員權限。
- Email 通知。
- 課程影片與下載。
固定維護節奏可參考課程網站維護清單。
課程網站常見衝突情境
| 症狀 | 常見排查方向 |
|---|---|
| 結帳按鈕沒反應 | 前端 JS、快取、金流、WooCommerce |
| 付款成功沒開課 | 訂單狀態、LMS 整合、權限 |
| 登入後版面錯亂 | 會員外掛、快取、佈景主題 |
| Elementor 元件失效 | 前端最佳化、JS、外掛版本 |
| 後台白畫面 | PHP fatal error、記憶體、外掛／主題 |
外掛衝突常見問題
可以直接在正式站停用全部外掛測試嗎？
課程、電商與會員網站不建議這樣做，因為會直接影響訪客與交易。優先使用 staging 或只影響管理員工作階段的 Troubleshooting Mode。
更新外掛後出錯，要立刻降版嗎？
先確認錯誤是否真的由該版本造成並保留備份。降版可能暫時恢復，但也可能失去安全修正；最好同步查看原廠相容性與修正資訊。
外掛越少就一定越穩嗎？
不是單純看數量。功能重複、品質差或長期未更新的外掛比較值得優先處理。真正重點是每個外掛的用途清楚、持續維護，而且彼此相容。
排錯的目標，是找到原因，不是把功能一直關掉
先重現、備份、看 log，再用測試環境逐一縮小範圍，通常比「全部關掉再看運氣」可靠。找到真正衝突組合後，才決定更新、替換、調整設定或請原廠協助。