解决 Jetpack 错误

WordPress.com 上的大多数 Jetpack 连接错误会自行解决，但有些需要手动修复。本指南介绍了您可能遇到的常见 Jetpack 错误以及相应的解决方法。

在大多数情况下，Jetpack 会自行修复并解决问题，无需人工干预，但即使 Jetpack 已自行修复，您可能仍会看到该错误。

您首先应采取标准步骤，排除任何浏览器或网络相关问题：

• 强制刷新
• 清除浏览器缓存
• 清除 WordPress.com Cookie
• 退出 WordPress.com 并重新登录。
• 进一步排查故障，例如尝试另一个浏览器、设备或网络

在排除浏览器和网络问题后，您可以继续阅读以下部分的内容，了解有关常见 Jetpack 错误的详细说明。

您可以按照以下步骤查看您的连接详细信息，包括连接到您的 WordPress.com 账户的本地用户：

1. 访问您站点的仪表盘。
2. 访问“Jetpack → 设置”并点击右侧的“仪表盘”按钮（如果使用 WP Admin，则请访问“Jetpack → My Jetpack”）。
3. 滚动到“连接”部分。
   • 站点连接：显示拥有该 Jetpack 连接的用户。
   • 账户连接：显示您账户的连接状态，包括与该连接关联的电子邮件地址。

如果您不是站点连接所有者，则可以断开您的用户账户与 Jetpack 的连接。或者，如果您的用户账户未连接到 Jetpack，您将看到一个“连接”按钮，用于连接您的用户账户。

要使 Jetpack 连接自行修复功能生效，您的 WordPress.com 账户中的电子邮件地址必须与站点的 WP Admin 用户账户中使用的电子邮件地址一致。如果这两个地址不一致，您可能会遇到反复出现的连接错误，而 Jetpack 无法自动修复这些错误。

要比较这两个电子邮件地址，请按照以下步骤操作：

1. 在“账户连接”部分（在您按照上述步骤操作后，该部分即会显示），查看与您的 WordPress.com 账户关联的电子邮件地址。
2. 在 WP Admin 中，转到“用户 → 所有用户”，然后编辑您的个人资料以查看记录的电子邮件地址。
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 Admin（本地）账户已被删除。要解决此问题，请按照以下步骤操作：

1. 访问“Jetpack → 设置”并点击右侧的“仪表盘”按钮（如果使用 WP Admin，则请访问“Jetpack → My Jetpack”）。
2. 点击屏幕顶部错误消息中的“创建账户”链接。

3. 在“添加用户”屏幕上，系统将自动填充与套餐所有者匹配的电子邮件地址。添加用户名。如果您不知道套餐所有者的用户名，则输入任意用户名均可。电子邮件地址才是关键所在。
4. 点击“添加用户”按钮。

当您返回“Jetpack → 设置”并点击右侧的“仪表盘”按钮（如果使用 WP Admin，则请访问“Jetpack → My 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 Admin，则请访问“Jetpack → My 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_。您可以通过 SSH 访问并执行以下命令来确认实际使用的前缀：wp db query “SHOW TABLES;”

如果问题在于表缺失，则您可以通过 SSH 访问并使用 WP-CLI 命令来导入此表的备份版本（如果您有权访问的话）。

如果您需要帮助确认数据库前缀，或将可用的表恢复到您的站点，请联系我们。

有时，由于 Jetpack 连接出现问题，默认 Admin 仪表盘中可能会显示诸如“您尚未发布任何页面”之类的消息。虽然相关内容在 WP Admin 仪表盘中可能仍然存在，但默认 Admin 仪表盘中的“页面”和“文章”部分可能会显示空白屏幕。

如果您发现默认 Admin 中的博客文章和页面列表为空，请清除您站点的缓存，排查您站点插件的问题，并检查是否存在任何 Jetpack 连接问题。

如果这未能解决问题，请联系我们。

在极少数情况下，您可能会看到表明 Jetpack 无法连接的错误，并且您的站点地址会显示一个 tmp（临时）URL。发生这种情况时，您需要联系我们快乐的工程师来解决问题。

如果您已尝试所有用于排查 Jetpack 连接问题的步骤，但因无法访问站点仪表盘而无法完成任何操作，则需要联系我们快乐的工程师来解决问题。请在提交请求时提供以下信息：

• 您看到的错误的确切文本。
• 您在错误出现之前采取的操作。
• 列出您最近安装的插件或主题。
• 在此错误出现前，您是否向站点上传过任何内容。