我一直很欣赏 WordPress 的一点是，即使你不是开发者，也能用它做很多事情。
但偶尔，有些东西会突然失灵。可能是插件更新导致的，也可能是一个设置悄悄地在后台引发了问题。
作为一个有 13 年以上 WordPress 教学经验的人，我有机会排查几乎所有类型的问题。在本指南中，我将带你通过 17 个久经考验的步骤，修复常见的 WordPress 错误，从清除缓存到扫描恶意软件。
你不需要懂技术也能修复 WordPress 问题。你只需要一个可靠的流程，这就是我将要与你分享的。
什么是 WordPress 错误？为什么我要关心？
WordPress 错误是指任何阻止你的网站正确加载、显示内容或按预期运行的问题。有时你会看到类似“404 Not Found”或“Internal Server Error”的消息。其他时候，可能只是页面加载不正确或显示空白。
我见过的一些最常见的 WordPress 错误包括白屏死机（一个没有任何错误信息的空白页）、数据库连接问题以及插件页面损坏。这些问题甚至可能在维护良好的网站上突然出现。
我之所以关心快速修复这些问题，是因为一个损坏的网站会让人感到很有压力。它也会给访客留下不专业的印象，导致他们在看到内容之前就离开。
更糟糕的是，有些问题会在后台悄悄拖慢你的网站速度或造成安全漏洞。这就是为什么我总是建议发现错误就立即修复。
如果你看到跳出率高或加载速度慢，可能就与这些问题之一有关。如果错误长期存在，你还会遇到 SEO 或网站排名方面的问题。
好消息是，大多数问题比看起来要容易解决。我将一步步带你进行故障排除，首先从我自己遇到问题时的第一步开始。
如何对 WordPress 错误进行故障排除
现在你已经知道什么是 WordPress 错误以及它们为什么重要，是时候学习如何修复它们了。一开始，对这些错误进行故障排除可能看起来棘手，但有了正确的步骤，你就能轻松处理它们。
以下是我们在后续部分将涵盖的所有步骤的快速概览：
- 为你的 WordPress 网站创建完整备份
- 研究你的错误信息
- 清除浏览器缓存
- 清除 WordPress 缓存
- 临时停用所有已安装的插件
- 切换到默认主题
- 删除 .maintenance 文件
- 启用 WP_DEBUG 并检查错误日志
- 回滚最近的插件或主题更新
- 刷新你的固定链接
- 备份并重新生成 .htaccess 文件
- 检查网站地址和 WordPress 地址
- 检查搜索引擎可见性设置
- 使用 SMTP 修复 WordPress 邮件问题
- 扫描恶意软件和黑客攻击
- 使用 AI 工具帮助排查错误
- 遇到困难时获得更好的支持
- 如何避免常见的 WordPress 问题（最佳实践）
- 关于 WordPress 故障排除问题的常见问答
- 更多有用的 WordPress 故障排除指南
准备好了吗？让我们开始让你的网站重新运行起来！
1. 为你的 WordPress 网站创建完整备份
在接触网站的任何东西之前，我做的第一件事就是创建完整备份。无论问题看起来有多小，拥有最近的备份都能让我安心，并在需要时提供回滚的方法。
如果你已经在使用备份插件，请确保在安全的地方保存了一份新的副本。我通常会把备份保存在云存储中，比如 Dropbox 或 猫哥推荐的云存储，并且我建议至少保留两份副本以防万一。
我在多个网站上使用过的插件之一是 Duplicator。它允许你备份整个 WordPress 网站，并通过几次点击将其存储在 Google Drive、Dropbox 或 S3 等服务上。
如果你还没有使用备份插件，那么现在是时候开始了。你可以查看我推荐的 WordPress 备份插件列表，找到适合你设置的插件。
如果你被锁在 WordPress 管理区之外，别担心。你仍然可以使用 FTP 客户端和 phpMyAdmin 手动备份你的数据库和文件。
2. 研究你的错误信息
当 WordPress 网站出现问题时，我首先寻找的是错误信息。有时它会出现在浏览器标签页中，比如“404 Not Found”或“Internal Server Error”。其他时候，它会出现在 WordPress 仪表盘内，比如媒体库中的“HTTP error”。
如果有错误信息，我通常会复制并粘贴到 猫哥 网站的搜索栏中。例如，搜索“Error Establishing a Database Connection”会带你到我们关于如何修复它的完整指南。
如果你看到类似下图的信息，那是个好迹象。这意味着 WordPress 正在给你一个线索，你可以用它来找到解决方案。
如果你的确切错误没有列在我们的故障排除库中，只需搜索你遇到问题的关键词或类型。你很可能会找到一个接近的匹配项。
你也可以检查你的 WordPress 网站错误日志，以获取更多线索。我将在后面的步骤中向你展示如何操作。
3. 清除浏览器缓存
有时，当你进行故障排除时，问题根本不在你的网站。只是你的浏览器保留了一个页面的旧版本。
我见过很多这样的情况，尤其是在有人更新插件或更改设置之后。许多浏览器会临时存储网站内容，如图像、样式表或脚本，以帮助页面加载更快。
但是，如果你的网站最近发生了变化，你的浏览器可能不会立即显示这些变化。这可能会让你觉得有些东西坏了，即使它已经修好了。
这就是为什么我总是建议首先清除浏览器缓存。这是一个简单的方法，可以确保你正在查看网站的最新版本。
如果你不确定如何操作，这里有我关于如何在 Chrome、Firefox、Safari 等浏览器中清除缓存的完整指南。
4. 清除 WordPress 缓存
即使清除了浏览器缓存，你可能仍然看不到网站的最新版本。这是因为 WordPress 缓存的工作方式不同。
为了澄清区别：浏览器缓存保存在你的设备上，帮助你更快地加载以前访问过的页面。WordPress 缓存保存在你的网络服务器上，有助于减少所有访客的加载时间。
当我在进行故障排除时，我总是清除两者，这样我就能确保看到网站的实时版本。
WordPress 缓存通常由你的托管服务提供商或像 WP Rocket、WP Super Cache 或 LiteSpeed Cache 这样的插件处理。这些工具通过提供页面的静态版本来帮助加速你的网站，而不是在每次访问时重新构建它们。
这对性能来说很棒，但是当你进行故障排除时，它可能会让你的修复看起来好像还没有生效。
大多数缓存插件会在 WordPress 管理栏中添加一个“清除缓存”或“清除所有缓存”的选项。在故障排除过程中，我总是在进行任何更改后点击这个选项。
具体细节，请查看我关于如何在 WordPress 中清除缓存的指南。
一些托管 WordPress 主机，如 SiteGround 或 Bluehost，也运行服务器端缓存。这意味着你可能还需要从你的托管仪表盘中清除缓存。
5. 临时停用所有已安装的插件
插件冲突是另一个可能导致 WordPress 网站损坏或使某些功能出现意外行为的原因。只需要一次插件更新就可能触发意外错误。
当我怀疑是插件问题时，我做的第一件事就是一次性停用所有插件。这有助于我确认错误是否与插件相关。然后，我一个一个地重新激活它们，找出导致问题的那个。
如果你仍然可以访问你的 WordPress 仪表盘，请前往 插件 » 已安装的插件。使用复选框选择所有插件，然后从“批量操作”下拉菜单中选择“停用”，然后点击“应用”。
如果你无法访问管理区域，你仍然可以使用 FTP 或托管控制面板中的文件管理器应用来停用插件。只需连接到你的网站，并将 wp-content 文件夹内的 plugins 文件夹重命名为类似 plugins-deactivated 的名称。
如果你不确定如何操作，请按照本指南操作：如何在不访问 wp-admin 的情况下停用所有插件。
一旦你的插件被停用，检查问题是否消失。如果一切看起来正常，你可以回去，一次激活一个插件。一旦错误再次出现，你就知道哪个插件是罪魁祸首了。
然后，你可以卸载该插件或寻找更好的替代品。
6. 切换到默认主题
有时问题不在于插件，而在于主题。我见过一些主题，由于代码过时或兼容性差，完全破坏了 WordPress 管理区域或导致空白页面。
为了排除这种可能性，我建议临时将你的主题切换为默认的 WordPress 主题，比如 Twenty Twenty-Four 或 Twenty Twenty-Five。
这些主题由 WordPress 团队构建和维护，因此用于测试是安全的。如果你的网站上没有安装默认主题，你可以点击顶部的“添加主题”按钮来安装它。
详情请参阅我们关于安装 WordPress 主题的教程。
如果你可以访问仪表盘，只需前往 外观 » 主题 页面，激活一个默认主题，然后检查问题是否消失。如果问题消失，那么你当前的主题可能就是问题所在。
如果你无法访问 wp-admin，你可以通过编辑 wp-config.php 文件或使用 phpMyAdmin 来手动切换主题。这里有一个指南，可以一步步引导你完成：如何通过 phpMyAdmin 禁用 WordPress 主题。
一旦你确认问题是由主题引起的，你可以重新安装一个新的副本，或者寻找一个编码正确且定期更新的替代主题。
7. 删除 .maintenance 文件
当你更新插件、主题或核心文件时，WordPress 会自动将你的网站置于维护模式。通常，这只会持续几秒钟，但有时那个临时的维护模式会卡住。
如果你看到一条消息说：“Briefly unavailable for scheduled maintenance. Check back in a minute.”，那么你的网站仍在尝试加载一个名为 .maintenance 的文件。
要修复它，你只需删除网站根文件夹中的 .maintenance 文件即可。你可以使用 FTP 客户端或登录到你的托管账户并使用文件管理器应用来执行此操作。
一旦该文件被删除，你的网站应该会立即恢复在线。如果没有，请再次清除你的 WordPress 和浏览器缓存，看看更新后的版本。
你也可以查看我的完整教程：如何修复 WordPress 中的维护模式错误。
8. 启用 WP_DEBUG 并检查错误日志
当我仅仅通过查看无法找到根本原因时，我会求助于错误日志。WordPress 有一个内置的方式来显示隐藏的错误，从启用名为 WP_DEBUG 的东西开始。
为此，请使用 FTP 或你的托管文件管理器连接到你的网站。然后打开 WordPress 网站根目录中的 wp-config.php 文件。
找到写着/* That's all, stop editing! Happy publishing. */的那一行，并在其上方添加以下代码：
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );这将启用调试，并将所有错误发送到一个名为 debug.log 的文件中，该文件位于 wp-content 文件夹内。
之后，重新加载出现错误的页面。然后回到 wp-content/debug.log 并将其下载。
你通常会在那里找到指向特定插件、主题或代码行的错误消息。我通过这种方式捕获了数十个在前端不可见的隐藏问题。
如果你不确定如何解释日志，你可以复制错误消息并将其粘贴到 Google 中，或者用它来向你的开发者或托管服务提供商寻求帮助。
你也可以按照我的完整指南操作：如何查找和访问 WordPress 错误日志。
提示： 如果你不想直接编辑 wp-config.php 文件，你可以使用 WPCode 将调试代码作为片段添加。这使得在不接触核心文件的情况下更容易开启和关闭调试。
9. 回滚最近的插件或主题更新
有时更新会出错。我遇到过插件更新表面上看起来没问题，但却在多个页面上引起微妙错误的情况。
最近，我看到一个画廊插件更新导致一个客户网站的 47 篇文章的精选图片被破坏。发生这种情况时，回滚到以前的版本通常可以立即修复问题。
如果你在问题出现之前最近更新了插件或主题，那是一个很好的起点。你可以使用像 WP Rollback 这样的插件，无需任何编码或 WP-CLI 即可快速恢复到稳定版本。
只需安装 WP Rollback 插件，然后转到你想要回滚的插件或主题。你会看到一个“Rollback”链接旁边。从那里，选择对你有效的版本，然后按照提示操作。
如果你不想使用其他插件，你可以手动安装一个旧版本。只需从 WordPress 插件仓库下载它，并通过 FTP 上传。这种方法有效，但更高级，如果你不小心，更容易搞砸。
无论哪种情况，请确保在进行更改之前创建备份，以防你需要再次切换回来。
有关详细说明，请按照我们的分步教程操作：如何回滚 WordPress 更新。
10. 刷新你的固定链接
WordPress 使用称为固定链接的东西来构建干净、对 SEO 友好的 URL。但有时，这种结构可能会不同步，尤其是在移动网站、更改别名或从备份恢复之后。
如果你在点击文章或页面时看到 404 错误，这是我最推荐首先修复的事情之一。只需几秒钟，你就可以重新构建固定链接，而无需更改网站上的任何其他内容。
在你的 WordPress 仪表盘中，前往 设置 » 固定链接。
页面会显示 WordPress 固定链接设置。但是，你不需要更改它们。只需向下滚动并点击“保存更改”按钮，无需进行任何更改。
这单次点击会强制 WordPress 重新生成你的 .htaccess 文件并刷新固定链接规则。在许多情况下，这会立即修复问题。
你也可以按照我们的完整教程操作：如何在 WordPress 中重新生成固定链接。
11. 备份并重新生成 .htaccess 文件
如果你的网站显示 500 内部服务器错误，可能是由损坏或损坏的 .htaccess 文件引起的。我见过这种情况在迁移或某些插件安装后发生。
修复方法很简单：删除该文件，让 WordPress 创建一个新的。但在这样做之前，我总是建议下载一个备份，以防万一。
首先，使用 FTP 客户端连接到你的网站，并打开你域名的文件夹。在里面，找到 public_html 目录。
你应该会看到你的 .htaccess 文件在那里。如果它缺失了，你的 FTP 设置可能隐藏了点文件。你可以按照我们的指南操作：为什么 .htaccess 文件可能不出现。
要备份它，右键点击文件并选择“下载”。
一旦你保存了备份，从服务器上删除原始文件。然后前往你的 WordPress 仪表盘中的 设置 » 固定链接，并点击“保存更改”。
该点击会自动生成一个全新的、可用的 .htaccess 文件，无需任何手动编码。
12. 检查网站地址和 WordPress 地址
如果你的网站出现奇怪的跳转、样式加载失败，或者登录后自动登出，那么你的 URL 设置不匹配可能是问题所在。
我帮助过很多用户在移动网站或切换域名时修复这个问题。即使是微小的不匹配，比如缺少“www”或错误的 HTTP/HTTPS 版本，也可能导致问题。
在你的 WordPress 仪表盘中，前往 设置 » 常规。你会看到两个重要的字段：
- WordPress 地址 (URL) – 这是你的 WordPress 核心文件安装的位置。
- 网站地址 (URL) – 这是人们在浏览器中输入以访问你网站的内容。
这两个字段通常应该完全匹配。如果你更改了域名或移动了网站，请仔细检查两个 URL 是否正确。然后点击“保存更改”。
如果你无法访问你的仪表盘，你仍然可以通过编辑你的 wp-config.php 文件来修复这个问题。添加包含你正确域名的这些行：
define( 'WP_HOME', 'https://example.com' );
define( 'WP_SITEURL', 'https://example.com' );确保将 https://example.com 替换为你的实际域名。
如需更多帮助，请查看我们关于修复 WordPress 登录页面重定向问题的完整指南。
13. 检查搜索引擎可见性设置
如果一个网站没有出现在 Google 上，我首先检查的事情之一是阅读设置屏幕。WordPress 有一个选项可以阻止搜索引擎索引你的网站，而且很容易被忽略。
要检查此设置，请前往你的 WordPress 仪表盘中的 设置 » 阅读。
现在向下滚动到页面底部。你会看到一个标记为“搜索引擎可见性”的复选框。
如果此框被选中，WordPress 正在告诉搜索引擎忽略你的网站。我见过这种情况发生在有人启动网站但忘记在开发后取消选中它。
提示： 我使用 All in One SEO (AIOSEO)，这是最好的 WordPress SEO 插件，它会自动检查并在我的网站阻止搜索引擎时提醒我。详情请参阅我的完整 AIOSEO 评测。
要修复它，只需取消选中该框并点击“保存更改”。这会让搜索引擎开始索引你的内容。
如果你仍在开发你的网站，并且不希望它被索引，那完全没问题。但是，与其隐藏整个网站，我建议使用即将到来的页面。它更有利于 SEO，并让你及早开始收集潜在客户。
你可以按照我们的教程操作：如何使用 SeedProd 在 WordPress 中创建漂亮的即将到来页面。这是我们启动新项目时使用的相同工具。关于 SEO 优化，你还可以参考我的GEO SEO 优化指南。
14. 使用 SMTP 修复 WordPress 邮件问题
如果你的网站没有发送邮件通知，例如表单提交、密码重置或管理员警报，问题通常是由托管服务器引起的。我见过很多网站出现这种情况，因为服务器没有正确配置来处理外发邮件。
当你使用联系表单插件时，这个问题会变得更加明显。你的访客可能认为他们联系到了你，但你从未收到他们的消息。
它还会阻止 WordPress 发送关键站点通知，包括安全警报和关于可疑登录活动的警告。
最好的解决方案是使用 SMTP (简单邮件传输协议)。SMTP 是一种发送邮件的标准方法，它会对你的消息进行身份验证，并确保它们成功送达你的收件箱。
我在我所有的网站上使用 WP Mail SMTP。它适用于 Gmail、Outlook、Amazon SES 和其他主要电子邮件服务。此外，它还会保留邮件日志，以便你可以确认消息是否确实从你的网站发送了。
要开始使用，请按照我们的完整指南操作：如何修复 WordPress 不发送邮件的问题。我们还比较了最好的 SMTP 提供商，如果你想探索你的选择。
15. 扫描恶意软件和黑客攻击
当 WordPress 网站感觉不对劲时，比如出现意外的跳转、奇怪的管理活动或文件丢失，我总会首先扫描恶意软件。最好排除它，而不是忽视它并冒着你的数据或声誉的风险。
大多数初学者不会立即安装安全扫描器，这为恶意代码在后台悄悄潜伏留下了机会。黑客经常将脚本隐藏在主题或插件文件夹中，使其难以被发现。
我建议使用像 Sucuri 或 Malcare 这样的受信任工具扫描你的网站。它们会扫描后门、注入代码和可能危及你网站的文件更改。
猫哥 在切换到 Cloudflare Enterprise 以获得更强的防火墙保护之前，多年来一直使用 Sucuri。我在所有个人网站上使用 Cloudflare 的免费 CDN，并结合 Sucuri 的免费扫描器进行快速检查。
如果你怀疑你的网站已经被黑客入侵，请按照我们的指南操作：如何扫描你的 WordPress 网站以查找潜在的恶意代码。
你也可以深入了解我们的完整 WordPress 安全指南。它详细介绍了我用来保护自己网站安全的所有方法。
16. 使用 AI 工具帮助排查错误
AI 工具在排查 WordPress 错误方面变得出奇地有用。当我需要快速解释错误消息或想集思广益寻找可能的原因时，我已经开始定期使用它们。
像 Google Gemini、ChatGPT 和 Claude 这样的工具可以分析错误消息、建议修复方法，甚至帮助你理解技术代码片段。当你卡住并需要一个新的视角时，它们特别有用。
以下是我如何有效使用 AI 工具进行 WordPress 故障排除的方法：
- 复制并粘贴你的错误消息。 当你在 debug.log 文件或屏幕上看到错误时，将完整的错误消息粘贴到 AI 工具中。让它解释错误消息的含义并建议可能的修复方法。
- 清楚地描述你的情况。 你提供的上下文越多，AI 就能提供越好的帮助。包括出现错误时你在做什么、你最近做了哪些更改以及你使用的是哪个托管服务。
- 要求分步说明。 当你要求 AI 将修复方法分解为简单的步骤时，它的效果最好。你可以这样说：“像我这样从未使用过 FTP 的初学者一样解释如何修复这个问题。”
- 使用 AI 理解代码片段。 如果教程要求你将代码添加到 functions.php 文件或 wp-config.php 中，你可以将代码片段粘贴到 AI 工具中，让它解释每一行的作用。这有助于你理解修复方法，而不是盲目复制。
- 双重检查 AI 建议。 虽然 AI 工具有帮助，但它们并不完美。在对你网站进行更改之前，请务必根据像 猫哥 或官方 WordPress 文档这样的可靠来源验证建议。
提示： 我推荐使用 Google Gemini 进行 WordPress 故障排除，因为它可以搜索网络以获取最新信息。这意味着它可以在帮助你修复问题的同时，找到最近的解决方案并检查官方文档。
AI 工具并不能替代正确的故障排除步骤，但它们是您工具箱中的一个很好的补充。它们可以节省您的时间，并帮助您了解幕后发生的事情。
有关使用 AI 与 WordPress 的更多技巧，请参阅我们的指南：如何在 WordPress 中使用 AI 进行 SEO 优化。
17. 在遇到困难时获得更好的支持
遵循这些故障排除步骤，你可以修复大多数常见的 WordPress 错误。但是，如果你的网站仍然有问题，那么还有其他方法可以获得额外的支持。
WordPress 拥有一个庞大且乐于助人的社区。你总是可以在 WordPress 支持论坛或 猫哥 Facebook 群组中向其他 WordPress 用户和专家寻求帮助。
在向社区寻求帮助时，重要的是要记住，你是在请求人们花费他们宝贵的时间并免费回答你的问题。
考虑到这一点，务必：
- 保持礼貌和友善。 无论你有多沮丧或生气，都不要使用严厉或不愉快的语言。
- 简要说明你的问题。 这将使人们更容易看到问题是什么，并决定他们是否能提供帮助。
- 描述你到目前为止已经采取的故障排除步骤。 这表明你不仅仅是希望别人免费为你工作。
- 提供你的网站 URL。 这允许人们查看问题，并可能在不需要登录的情况下提供更准确的帮助。
如果你需要更快速的帮助，许多 WordPress 托管服务提供商，比如 Hostinger，提供 24/7 的客户支持，可以协助解决服务器相关的问题。
如何避免常见的 WordPress 问题（最佳实践）
预防总是胜于治疗。以下是一些我用来保持网站平稳运行的最佳实践：
- 保持一切更新。 定期更新 WordPress 核心、主题和插件。更新通常包括安全补丁和错误修复。
- 使用可靠的托管服务。 一个好的托管服务提供商，比如 Hostinger，可以防止许多常见问题。
- 定期备份。 设置自动备份，这样你总是有最近的数据副本可以恢复。
- 只安装必要的插件。 每个额外的插件都是一个潜在的错误或安全漏洞点。只保留你需要的插件。
- 在测试环境中测试更改。 如果可能，在将重大更改应用到你的实时网站之前，先在暂存或测试环境中进行测试。
- 使用强密码和安全措施。 使用强密码，并考虑实施双因素认证。
关于 WordPress 故障排除问题的常见问答
问：我是初学者，我应该尝试修复这些错误吗？
答：是的！本指南中的大多数步骤都设计为初学者友好。从简单的步骤开始，比如清除缓存，然后逐步进行。如果你感到不舒服，总可以寻求帮助。
问：如果我无法访问我的 WordPress 仪表盘怎么办？
答：许多步骤，比如停用插件或切换到默认主题，都可以通过 FTP 或你的托管控制面板完成。本指南涵盖了这两种方法。
问：我应该多久备份一次我的网站？
答：理想情况下，你应该每天或每周备份，具体取决于你更新内容的频率。许多托管服务提供商和插件提供自动备份。
问：最大的 WordPress 错误是什么？
答：最大的错误是没有备份。总是备份你的网站，以便在出现问题时可以恢复。