解決 Jetpack 錯誤

WordPress.com 上大部分的 Jetpack 連線錯誤會自行排除，但有些需要手動修正。本指引涵蓋可能會看到的 Jetpack 常見錯誤，以及如何解決每個錯誤。

在多數狀況下，Jetpack 會自行修復並解決問題，無須手動操作，但在 Jetpack 自行修復後，可能會繼續看到錯誤。

第一步應採取標準步驟，排除任何瀏覽器或網路相關問題：

• 強制重新整理
• 清除瀏覽器快取
• 清除 WordPress.com Cookie
• 登出 WordPress.com 並重新登入。
• 進一步疑難排解，例如嘗試其他瀏覽器、裝置或網路

排除瀏覽器和網路問題後，可以繼續前往以下區段，詳細說明常見的 Jetpack 錯誤。

可以按照下列步驟來檢視連線詳細資料，包括哪些本機使用者已連線至你的 WordPress.com 帳號：

1. 造訪網站的儀表板。
2. 造訪「Jetpack」→「設定」並按一下右側的「儀表板」按鈕 (如果使用 WP 管理員，請造訪「Jetpack」→「我的 Jetpack」)。
3. 捲動至「連結」區段。
   • 網站連結：顯示擁有 Jetpack 連結的使用者。
   • 帳號連結：顯示帳號的連結狀態，包括與連結相關的電子郵件地址。

如果你不是網站連結的擁有者，可以中斷使用者帳號與 Jetpack 的連結。或者，如果使用者帳號未連結至 Jetpack，則會看到「連結」按鈕來連結使用者帳號。

若要讓 Jetpack 連結的自我修復正常運作，WordPress.com 帳號的電子郵件必須符合網站 WP 管理員的使用者帳號所使用的電子郵件。如果兩個地址不相符，可能會看到 Jetpack 無法自動修復的重複連結錯誤。

若要比較兩個電子郵件地址，請依照下列步驟執行：

1. 在「帳號連結」區段中 (依照上述步驟操作時會顯示)，請注意連結至 WordPress.com 帳號的電子郵件。
2. 在 WP 管理員中，前往「使用者」→「全部使用者」，然後編輯個人檔案，以檢視檔案中的電子郵件。
3. 如果兩個地址不同，請更新其中一個以確保相符。若要變更 WordPress.com 帳號的電子郵件，請參閱變更電子郵件地址。

相符的電子郵件是 Jetpack 自我修復的數項需求之一。即使有相符的電子郵件，連結仍可能因為其他原因而失敗，例如若網域並未指向你的網站。

如果你是網站的管理員，可能會看到以下錯誤訊息：

This site needs to be connected to WordPress.com by the plan owner account with email [email address]. Please create a local user account with this email address to resolve this issue.

此訊息表示方案擁有者的 WP 管理員 (本機) 帳號已刪除。若要解決此問題，請依照步驟操作：

1. 造訪「Jetpack」→「設定」並按一下右側的「儀表板」按鈕 (如果使用 WP 管理員，請造訪「Jetpack」→「我的 Jetpack」)。
2. 按一下畫面上方錯誤訊息中的「建立帳號」連結。

3. 在「新增使用者」畫面中，將會自動填入符合方案擁有者的電子郵件地址。新增使用者名稱。如果不知道方案擁有者的使用者名稱，可以使用任何使用者名稱。電子郵件地址才是重要的一環。
4. 按一下「新增使用者」按鈕。

返回「Jetpack」→「設定」並按一下右側的「儀表板」按鈕時 (如果使用 WP 管理員，請造訪「Jetpack」→「我的 Jetpack」)，錯誤訊息會消失，表示問題已解決。

Error Message: We can’t communicate with your site because the Jetpack plugin is deactivated.

Error Message: Jetpack can’t communicate with your site because your site isn’t connected.

託管於 WordPress.com 且支援外掛程式的網站必須啟用 Jetpack，才能正常運作。無法在 WordPress.com 上中斷連結、關閉或停用 Jetpack。在極少數情況下，從其他主機移轉網站時，可能需要在移轉完成後還原或重新連結 Jetpack。

若要重新連結 Jetpack，請依照下列步驟操作：

1. 造訪網站的儀表板。
2. 造訪「Jetpack」→「設定」並按一下右側的「儀表板」按鈕 (如果使用 WP 管理員，請造訪「Jetpack」→「我的 Jetpack」)。
3. 按一下「恢復連結」或「設定 Jetpack」按鈕，即可將 Jetpack 重新連結至網站。

如果沒有看到「恢復連結」或「設定 Jetpack」訊息，且 WordPress.com 儀表板沒有發生任何其他問題，請詳閱本指引「基本 Jetpack 疑難排解」區段中的建議。這通常表示 Jetpack 已自我修復，但瀏覽器已快取錯誤訊息。

在大多數情況下，下列錯誤表示自訂網域有問題：

Error Message: The URL stored by the Jetpack servers does not match your site.

Error Message: The Jetpack site is inaccessible or returned an error: transport error - HTTP status code was not 200.

Error Message: Jetpack is unable to connect to your domain because your domain’s DNS records aren’t pointing to your site.

SSL: no alternative certificate subject name matches target host name

如果發現與 URL、無法存取、DNS 或 SSL 相關的錯誤，則自訂網域尚未準備好用於你的網站。可以暫時使用預設的網站位址作為網站的主要網域，讓 Jetpack 能正常運作。

請依照下列步驟將預設網站位址設為主要網域，直到你的網域可供使用為止：

選取管理員介面：

可以使用此位址繼續處理網站內容和設計。當你的網域完全啟用後，可以將它設為主要位址。

深入了解如何疑難排解網域錯誤。

在大多數情況下，下列錯誤表示網站有外掛程式或佈景主題衝突：

Error Message: Jetpack can’t communicate with your site due to a critical error on the site.

Error Message: Jetpack can’t communicate with your site because your site isn’t responding to requests.

Error Message: Jetpack can’t communicate with your site because XML-RPC is not responding correctly. 

Error Message: Jetpack can’t communicate with your site because the REST API is not responding correctly.

在大多數情況下，該嚴重錯誤是由最近安裝或更新的外掛程式所造成。錯誤頁面應包含造成錯誤的外掛程式或佈景主題的其他資訊。也可以檢閱 PHP 記錄，找出與網站嚴重錯誤相關的任何嚴重錯誤。

如果已經完成辨識外掛程式/佈景主題衝突的步驟，且未發生 WordPress.com 儀表板的任何其他問題，請詳閱本指引「基本 Jetpack 疑難排解」區段中的建議。這通常表示 Jetpack 已自我修復，但瀏覽器已快取錯誤訊息。

如果無法存取 WordPress.com 儀表板來停用佈景主題或外掛程式，請聯絡我們。

Error Message: The site you have requested is not installed.
Run `wp core install` to create database tables.

如果在 wp-config.php 中定義的預設資料表前綴與現有前綴不符，或網站缺少 wp_options 表格，就可能發生此錯誤。

如果問題在於表格前綴，且已經建立 SSH 或 SFTP 存取，則可以更新 wp-config.php 檔案，將前綴更新為正確版。預設前綴是 wp_。可以使用此命令 wp db query “SHOW TABLES;" 來確認與 SSH 存取一起使用的實際前綴

如果問題在於缺少表格，則可以透過 SSH 存取和使用 WP-CLI 指令，匯入此表格的備份版本 (如果有存取權)。

如需協助確認資料庫前綴或將工作表格還原到網站，請聯絡我們。

有時 Jetpack 連結的問題可能會在「預設管理員」儀表板中顯示「你尚未發表任何頁面」等訊息。內容可能仍可在「WP 管理員」儀表板中使用，但預設管理員儀表板的「頁面」和「文章」區段可能會顯示空白畫面。

若在「預設管理員」中發現部落格文章和頁面清單為空白，請清除網站的快取、疑難排解網站的外掛程式，並檢查是否有任何 Jetpack 連結問題。

如果無法解決問題，請聯絡我們。

在極少數情況下，可能會看到 Jetpack 無法連結的錯誤，而網站位址會顯示 tmp (暫時) URL。發生此狀況時，務必聯絡我們的 Happiness Engineer，以解決問題。

若已嘗試所有疑難排解 Jetpack 連結的步驟，但因無法存取網站儀表板而無法完成任何步驟，務必聯絡我們的 Happiness Engineer，以解決此問題。請在要求中提供下列資訊：

• 看到的錯誤確切文字。
• 在錯誤出現之前採取的動作。
• 最近安裝的外掛程式或佈景主題資訊。
• 在此錯誤出現前是否上傳任何內容至網站。