初步評估

The REST API encountered an error

WordPress 網站健康狀態出現「REST API 發生錯誤」(The REST API encountered an error):原因與檢查方式

中文介面顯示:REST API 發生錯誤
更新 2026-11-01

網站健康狀態對 REST API(/wp-json/)發出的測試請求回傳錯誤時,會列出這個重大問題。區塊編輯器與許多外掛也透過同一個 API 傳送請求,所以文章常常同時存不了檔。

你現在看到的是哪一種情況?

編輯器透過同一個 API 儲存,同一個原因讓兩者都失敗。

擋住這個路徑或請求方法的規則,會讓測試失敗。

/wp-json/ 這種網址依賴重寫規則;少了規則,請求會回傳 404。

常見原因

安全外掛或防火牆規則:規則擋下 /wp-json/ 或某些請求方法。
.htaccess 或 Nginx 規則:重寫規則沒有把 /wp-json/ 的請求交給 WordPress。
JSON 前面混了輸出:外掛在回應前面印出文字或 PHP 提示。
REST API 被關掉:外掛對部分或全部請求停用了這個 API。

參考資料

  1. Site Health screen (WordPress.org Documentation)
  2. REST API Handbook (Developer.WordPress.org)

不想自己動手處理?WP119 全自動修復

REST 路徑被擋或回應被污染時,編輯器會存不了檔;這一項屬於自動處理:系統修復 REST 路徑,並複驗編輯器能存檔。修復在維修站的網站副本上進行,複驗通過後才寫回。您網站資料庫裡的受保護資料表(會員、留言、訂單、表單填寫)只取結構。SSH/FTP 模式下,系統寫回前先在您的主機建立修復前備份,寫回後驗證沒通過時,以這份備份進行還原。修復未能完成,修復費全額退還。

  1. 初步評估:輸入網址
  2. 複製到維修站:在副本上作業
  3. 找出原因:逐項檢查
  4. 修復與複驗:首頁與內頁
  5. 寫回或交付:複驗通過才進行

網站健康狀態出現這個錯誤、區塊編輯器也存不了檔時,可以交給 WP119。

初步評估我的網站 →
初步評估 →