这是一个令人沮丧但常见的 WordPress 错误，它可能会突然出现，一举击倒您的网站：

“警告：无法修改标头信息 – 标头已由（输出开始于……）发送”

更糟糕的是，此错误仍在继续，列出服务器上重要文件的路径，这是潜在的安全风险。

但不用担心！ 这是更容易解决的错误之一，在这篇文章中，我将向您展示如何修复它以及如何隐藏错误消息以使其不显示在您网站的前端。

• 错误从何而来
• 如何修复“无法修改标题”错误
  • 修复 #1：上传新副本
  • 修复 #2：编辑故障文件
• 仍然无法修复错误？

错误从何而来

当然，这个错误可能看起来很吓人，几乎就像你的主题有问题 头文件.php 文件或类似的东西，但它实际上与您的一个文件中的额外间距有关。 有时它们会无意或自动添加，需要进行调整。

出现以下情况时会显示错误：

• 文档顶部或底部的空行
• 开头之前、中间或之后的空格太多 <?php 和结束 ?> PHP 标签
• 文档的特定部分中有太多不需要的空格或空行

为了解决间距问题，您需要首先知道它发生在哪里。 幸运的是，错误消息让您知道受影响的文件和行。 请记住，您可能会在页面上多次看到此序列，这意味着有多个文件需要修复。

为了破译损坏的文件，需要注意以下基本结构：

警告：无法修改标头信息 - 标头已由（输出开始于 /path/to/file/broken-file.php:#）在 /path/to/file/affected-file.php 行 #

第一个文件列为 /path/to/file/broken-file.php 将是需要修复的那个 # 直接在它之后的字符将被替换为一个数字，该数字会告诉您需要修复哪一行。

以这种结构编写的第二个文件为 /path/to/file/affected-file.php 是因为第一个文件损坏而无法正常工作的文件。 这 # 在实际示例中，末尾的符号将是一个数字，表示文档中受影响且无法工作的行。

以下是此错误在您的网站上的示例：

警告：无法修改标头信息 - 标头已由 /home/name/your- 中的（输出开始于 /home/name/you-site/wp-content/themes/your-theme/custom-functions.php:1）发送第 876 行的站点/wp-includes/pluggable.php

在这个例子中， name 将是您的 cPanel 或主机帐户的用户名，并且 your-site 将替换为存储站点的文件夹名称。 您实际看到的错误看起来会有所不同，但它应该让您对预期的结果有一个很好的了解。

在这个例子中， 自定义函数.php 在我的主题文件夹中是需要修复的文档，错误在第一行。

幸运的是，即使一开始看起来很吓人，解决这个问题也不是很困难。

请继续阅读以了解您的选择。

如何修复“无法修改标题”错误

有两种主要方法可以修复“无法修改标题”错误。 如果您在此过程中遇到困难，请随时与我们的专家支持团队取得联系。 他们还可以帮助您处理与 WordPress 相关的任何事情，他们 24/7 全天候可用，他们很乐意为您提供帮助。

否则，他们会急切地等待，直到您向他们提出问题，因此如果遇到麻烦，您不妨停下来，尤其是当您的 WPMU DEV 会员资格中包含高级和专家支持时。 如果您不是会员，您仍然可以免费试用我们并向专家寻求帮助。

修复 #1：上传新副本

当您阅读错误消息并确定损坏的文件是 WordPress 核心的一部分或者它是插件或主题的固有文件时，可以使用快速修复。

如果是常规插件或主题文件，您可以卸载并重新安装。

如果您不想这样做或 WordPress 核心文件受到影响，您可以下载一个新副本并将 ZIP 存档解压缩到您的计算机。 在您的站点上找到损坏的文件，并将服务器上的现有文件替换为新副本。

您可以借助 FTP、SSH 或直接通过 cPanel 来执行此操作。

修复 #2：编辑故障文件

一旦您确定了问题文件，您可以通过 FTP 或 SSH 下载它的副本，或者您可以直接在 cPanel 中对其进行编辑。

使用退格按钮或 删除 电脑按钮。 此外，请确保在前面、中间或后面没有空格 <?php 文件开头的标签。 这同样适用于 ?> 标记在最后。

如果文档的最后一行没有以 ?> 标记结尾，那么请确保在最后一行的最后一个字符之后仍然没有空格。

保存文件并将其上传回您的站点的同一位置，覆盖原始文件。

仍然无法修复错误？

如果您尝试了这些修复程序，但对于不同的文件或行仍然看到相同的错误，那是正常的。 重复这些步骤并继续清除那些多余的空格或空行。

如果你看到 精确的 与以前相同的错误，这里有一些额外的注意事项可以帮助您仔细检查您的工作：

• 如果您清除了所有多余的空格和行，但在此过程中按了任何其他键，则可能会导致问题再次出现，因此如果发生这种情况，请重试。
• 确保您的 PHP 文件中没有多个代码块。 你应该只有一个开口 <?php 在开头和一个标记 ?> 最后的结束标签。
• 确保文件的编码设置为 UFT-8。 如果设置为其他内容，请进行此更改，然后重试这些步骤。
• 如果您下载文件的副本并将其保存到您的计算机，请使用适当的代码编辑器。
  • 不要使用常见的文字编辑程序，例如 MS Word，因为它们会为文档添加额外的格式，从而进一步破坏您的网站。

禁用前端错误报告

到目前为止，您应该已经修复了文件，并且讨厌的“无法修改标题”错误应该已经消失了。 尽管如此，没有什么能阻止这些错误再次出现并被访问您网站的每个人（包括黑客）看到。

这并不是您的网站发生的最糟糕的事情，但是在您的服务器上显示真实的实时文件路径可能会给黑客提供他们针对您的网站所需的确切信息。 他们不会猜测您的文件将在哪里尝试破解它们，而是会看到它们清晰可见。 没有什么能阻止他们直接破解该文件。

您可以关闭前端错误报告并启用私有日志 WP_DEBUG. 您可以在我们的另一篇文章调试 WordPress：如何使用 WP_DEBUG 中查看所有详细信息。

编者注： 这篇文章已经更新，以确保准确性和相关性。 [Originally Published: Sept 2016 / Revised: February 2022]

• 错误
• 故障排除