為什麼 WooCommerce 會出現錯誤？
WooCommerce 功能強大，但與主題、外掛、金流串接等密切相關，當其中一環出現設定錯誤或版本不相容時，就可能導致：
- 結帳頁消失
- 商品頁錯誤顯示
- 金流無法串接
- 訂單紀錄異常
別擔心，這篇文章將帶你逐一解決最常見的問題。
利益揭露
我沒有收到任何的報酬來撰寫此篇文章，而且我只推薦我個人相信會對我的讀者帶來幫助的服務，如果你決定通過點擊本文中的連結來購買產品，那麼我可能會獲得一筆小額佣金，這將不會影響你的任何權益或是購買商品的價格。如果你想要支持我繼續經營本網站，請使用本站連結購買你需要的產品，我會非常感謝您。
一、WooCommerce 安裝與啟用問題
問題 1：啟用 WooCommerce 外掛時網站變空白（白畫面）
原因： 通常是主題或其他外掛與 WooCommerce 衝突
解法：
- 啟用
WP_DEBUG模式查看錯誤（在 wp-config.php 中啟用） - 停用所有外掛，再逐個啟用找出衝突來源
- 嘗試切換為預設主題（如 Storefront）
問題 2：WooCommerce 頁面顯示「404 找不到」
原因： 頁面未正確建立或固定連結未刷新
解法：
- 到【WooCommerce】>【狀態】>【工具】> 點選「建立預設 WooCommerce 頁面」
- 到【設定】>【固定連結】> 點選「儲存變更」刷新設定
二、金流錯誤與支付失敗問題
問題 3：Stripe 無法支付，出現 Payment Intent Error
原因： Stripe API 金鑰錯誤或未啟用測試模式
解法：
- 確認已貼上正確的 Live API Key 或 Test API Key
- 檢查付款方式是否啟用信用卡 / Apple Pay 等選項
- 開啟測試模式後可用假卡號測試（如 4242 4242 4242 4242）
👉 延伸閱讀：WooCommerce Stripe 整合教學
問題 4：綠界金流付款完成但 WooCommerce 無訂單
原因： 綠界與 WooCommerce 串接未成功
解法：
- 確認 Merchant ID、HashKey、HashIV 正確填寫
- 確保 WooCommerce 回傳網址（NotifyURL）設為 https 且對外開放
- 在綠界後台重新送出測試交易驗證串接是否成功
三、商品與購物車顯示異常
問題 5：商品無法加入購物車
原因： JavaScript 衝突或主題問題
解法：
- 切換為預設主題測試（如 Storefront）
- 停用快取外掛、CDN 或 JS 最小化功能後測試
- 使用瀏覽器檢查 Console 錯誤訊息
問題 6：商品價格顯示錯誤（例如：顯示 0 元）
原因： 未設定價格，或貨幣設定錯誤
解法：
- 確認【商品】中的「一般價格」欄位是否有填
- 到【WooCommerce】>【設定】>【一般】中確認幣別為「TWD」或你的營運幣別
四、進階排錯工具與建議
| 工具 / 方法 | 用途 |
|---|---|
| WP Debug | 啟用除錯訊息，顯示錯誤位置 |
| Query Monitor 外掛 | 查看目前執行的查詢與錯誤警告 |
| WooCommerce 狀態頁 | 查看系統環境、外掛版本與潛在問題 |
| Health Check 外掛 | 安全模式排查外掛與主題衝突 |
| WooCommerce 訂單紀錄 | 查看訂單狀態與付款回傳資訊（適用於串接問題） |
❓常見問答（FAQ）
Q1：每次 WooCommerce 更新都出錯怎麼辦？
A：更新前請先備份網站，並在非營業時間進行。 建議使用 Staging Site 測試更新再上線。
Q2：是否應該安裝 Debug 類外掛？
A：可短期安裝如 Query Monitor、Health Check 做除錯，用完請移除避免拖慢效能。
Q3：WooCommerce 支援哪裡可以求助？
A：可參考以下資源：
- 官方支援：https://woocommerce.com/my-account/create-a-ticket/
- WordPress 社群論壇
- 網頁開發社群（如 Reddit、Stack Overflow）
👉 下一篇教學
🔗 WooCommerce + Kinsta 電商主機推薦與設定指南（2025）
深入比較最適合電商的主機方案，幫助你選出穩定又快速的解決方案！