如何修復(fù) WordPress 中的無效 JSON 錯誤

在使用古騰堡塊編輯器的過程中，當 WordPress 無法與 Web 服務(wù)器通信時，就會出現(xiàn)無效 JSON 錯誤情況。

今天我們就來介紹如何查找和修復(fù)問題。

按照我們的經(jīng)驗，通常可以按照下面的步驟檢查：

• 找出簡單的事情是否是導(dǎo)致錯誤的原因。
• 檢查您的WordPress URL并在必要時更改它們。
• 調(diào)整你的永久鏈接設(shè)置，或者至少重建它們。
• 查看 WordPress 中的站點健康頁面以獲取有關(guān)如何進行的線索。
• 重建您的.htaccess 文件。

1. 執(zhí)行一些簡單的步驟來診斷錯誤

在您深入設(shè)置屏幕之前，您需要確保您不是 WordPress 中無效 JSON 錯誤的原因。但是，請先創(chuàng)建您網(wǎng)站的完整備份，以防您以后需要恢復(fù)您的網(wǎng)站。

做好網(wǎng)站備份以后，可以嘗試按照下面的步驟依次檢查：

• 切換到默認的WordPress主題，檢查是否因為主題導(dǎo)致錯誤。
• 如果您使用Web 應(yīng)用程序防火墻 (WAF)?，請關(guān)閉它。您可能會暫時禁用安全插件。
• 停用所用的WordPress插件，看看是否有一個是導(dǎo)致 WordPress 中無效 JSON 錯誤的原因。通常問題都是插件問題導(dǎo)致。
• 在編輯器界面，開啟瀏覽器自帶的開發(fā)者工具，看看是否有什么具體的報錯提示。
• 嘗試使用經(jīng)典編輯器插件 Classic Editor，看看你是否仍然可以實現(xiàn)你需要的東西而不會看到錯誤。有些主題和插件是不兼容古騰堡編輯器的。
• 激活WordPress 的調(diào)試模式，你可以看到更多錯誤信息。

2. 檢查您的 WordPress 網(wǎng)址

WordPress網(wǎng)址配置不正確，也是有可能導(dǎo)致無效 JSON 錯誤的，您需要登錄 WordPress 并前往“設(shè)置-常規(guī)”屏幕：

查看WordPress 地址 (URL)和站點地址 (URL)。在絕大多數(shù)情況下，這兩個字段的值應(yīng)該是完全一樣的。

按照我們的經(jīng)驗，如果你的網(wǎng)站開啟了 HTTPS，但是你沒有正確安裝SSL證書，或者上面兩個字段沒有同時設(shè)置為 https:// 網(wǎng)址，通常就會導(dǎo)致 無效 JSON錯誤。我們建議檢查每個 URL 中的拼寫錯誤，并檢查每個 URL 是否使用正確的協(xié)議。

進行修復(fù)后，保存更改并檢查錯誤。如果它仍然出現(xiàn)，請轉(zhuǎn)到下一個方法。

3. 調(diào)整您的 WordPress 固定鏈接設(shè)置

在“設(shè)置”頁面中，前往“固定鏈接”頁面。您的固定鏈接結(jié)構(gòu)可能存在問題，這可能會導(dǎo)致 WordPress 中出現(xiàn)無效的 JSON 錯誤。

這里的解決方案很簡單：

• 選擇固定鏈接類型。除非您使用自定義結(jié)構(gòu)，否則請堅持使用【文章名】選項。
• 保存您的更改。這將“刷新”您的固定鏈接設(shè)置，并且應(yīng)該消除 WordPress 中的無效 JSON 錯誤。

但是，如果您使用自定義固定鏈接結(jié)構(gòu)，請確保您使用的標簽沒有拼寫錯誤或語法錯誤。即使一個字符不合適也會導(dǎo)致錯誤，因此請修復(fù)您發(fā)現(xiàn)的任何內(nèi)容，保存您的更改，并檢查更多問題。

4. 查看站點健康日志以獲取線索

WordPress 包含一個方便的屏幕（工具 – 站點健康），可幫助您判斷網(wǎng)站的“健康”程度。站點健康頁面本質(zhì)上是一個關(guān)鍵問題列表和建議的改進，以幫助您站點的各個方面。例如，您可以優(yōu)化性能、進行搜索引擎優(yōu)化 (SEO)等：

如果您在 WordPress 中遇到無效 JSON 錯誤，您可能會看到另一個推薦的改進：“?REST API遇到意外結(jié)果”。這應(yīng)該會給您一些關(guān)于 JSON 錯誤所在位置的指示，并且您可以從那里進一步調(diào)查。

但是，如果您沒有太多閱讀此類錯誤日志的經(jīng)驗，您可能需要聯(lián)系您的網(wǎng)站開發(fā)商或主機商。這樣，他們可以告訴您問題與什么有關(guān)，以及是否是服務(wù)器端的問題。

5. 重建你的.htaccess文件

如果你的服務(wù)器采用的是 Apache 環(huán)境，一般在網(wǎng)站根目錄下都會有一個.htaccess文件，它是Apache 服務(wù)器的一組配置。

與Nginx不同，Apache 用戶可以處理服務(wù)器配置。因此，這可能會導(dǎo)致 WordPress 中出現(xiàn)無效的 JSON 錯誤。

這里最好的方法是重建.htaccess文件。事實上，您在保存更改固定鏈接設(shè)置時可能已經(jīng)這樣做了，因為在此處保存更改會重新生成.htaccess文件。

但是，您可能希望自己從頭開始創(chuàng)建一個干凈的文件，以確保不會引入錯誤或保留錯誤。

首先，您需要備份舊的.htaccess文件。

如果你用的是寶塔面板，可以登錄寶塔面板，在 文件 管理界面進入到網(wǎng)站所在的目錄就可以看到具體的文件：

或者你可以通過SFTP或FTP訪問您的服務(wù)器并將.htaccess文件拖到您的本地計算機上。這是您需要的：

對您的服務(wù)器的管理訪問權(quán)限以及登錄憑據(jù)。您通常可以在主機控制面板或主機的電子郵件中找到這些內(nèi)容。

• 合適的SFTP 客戶端，例如FileZilla、Cyber??duck或Transmit。
• 有關(guān)如何使用 SFTP的知識，我們在博客上的專門文章中對此進行了介紹。

您的.htaccess文件將位于站點主目錄的根目錄中，過程是將其拖到您的計算機上（并設(shè)置為顯示隱藏文件）：

從這里，在您的計算機上復(fù)制，清除內(nèi)容，然后添加以下內(nèi)容：

# BEGIN WordPress
 
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
 
# END WordPress

這是一個默認.htaccess文件。將其另存為.htaccess，然后再次將其上傳到您的服務(wù)器，然后檢查問題是否已處理。

總結(jié)

WordPress 中的無效 JSON 錯誤很容易理解和修復(fù)，此錯誤的大多數(shù)解決方案都與您的WordPress主題、插件、以及服務(wù)器的配置設(shè)置有關(guān)，通常按照我們的建議逐步排查，都可以找到問題所在。

如果還是沒有解決問題，建議你聯(lián)系網(wǎng)站開發(fā)者或主機商協(xié)助查看，服務(wù)器上可能有一些東西不能很好地與您的站點配置配合使用，他們需要對其進行調(diào)查。

您是否遭受 WordPress 中的無效 JSON 錯誤的困擾，我們的解決方案之一對您有幫助嗎？在下面的評論部分讓我們知道！

拓展閱讀：

• 11 個為開發(fā)者準備的 WordPress 調(diào)試插件
• 如何使用瀏覽器的開發(fā)者工具調(diào)試網(wǎng)站
• WordPress 調(diào)試模式基本指南
• WordPress 快速入門視頻教程48：固定鏈接設(shè)置詳解
• 網(wǎng)站管理員和Web開發(fā)人員.htaccess入門指南
• 詳細介紹 WordPress 配置文件 wp-config.php
• 寶塔面板下運維WordPress網(wǎng)站