在 Magento 2 中，有时您会遇到这样的问题：出现黑色页面或纯白色页面，并显示错误号，例如错误日志记录号：568837792838 或任何损坏的内容错误。

在 Magento 2 的默认设置中，允许在前端显示错误的功能是禁用的。因此，在今天的帖子中，我将指导您如何在 Magento 2 上显示错误消息或启用错误报告。

如何显示错误：启用错误报告

  • 方法 1：重命名 pub/errors/local.xml.sample 文件
  • 方法2：编辑.htaccess文件
  • 方法3：编辑app/bootstrap.php文件

方法 1：重命名 pub/errors/local.xml.sample 文件

要在浏览器上显示错误，您只需重命名一个 XML 文件即可。但是，如果您在生产环境中，则不建议使用此方法，因此您应该只考虑在开发环境中使用此方法。操作方法如下：

  • 首先，转到您的 Magento2 根目录。
  • 然后，打开pub/errors.
  • 打开后，您将看到一个名为 的文件local.xml.sample。
  • 将其从local.xml.sample重命名为local.xml。换句话说，您sample从文件名中删除了 。
  • 最后，System > Tools > Cache Management从 Magento 管理员转到刷新缓存。

方法2：编辑.htaccess文件

显示错误的第二种方法是编辑.htaccess fileMagento 2 站点的 。编辑该文件时，您将能够启用 Magento 的开发模式以及 PHP 的错误显示设置。

首先，打开文件.htaccess并在文件末尾写入以下代码：

php_value display_errors on ## enable PHP's error display settings
php_value error_reporting -1 ## set error display to E_ALL

添加代码后，打开终端/命令提示符并访问 Magento 的根目录。

cd /path/to/your/magento/directory

现在，运行以下命令来激活开发者模式。

php bin/magento deploy:mode:set developer

可以使用以下命令检查当前的部署模式：

php bin/magento deploy:mode:show

最后，使用以下命令清除缓存：

php bin/magento cache:clean

正确执行上述所有步骤后，当您浏览 Magento 网站时，您将看到浏览器本身显示错误。然而，就像第一种方法一样，这仅对开发环境有好处。

方法3：编辑app/bootstrap.php文件

除了编辑.htaccess file（这是在 Magento 站点上启用错误显示的首选方式）之外，您还可以编辑 PHP 文件。要编辑该文件，请按照以下步骤操作：

  • 首先，访问 Magento 的根目录。
  • 然后，打开该文件app/bootstrap.php。
  • 在文件的开头，您将看到以下行代码：#ini_set('display_errors', 1); 看到后，请将代码更新为：

error_reporting(E_ALL); # Set Error Reporting as E_ALL (Report all PHP errors)
ini_set('display_errors', 1); # Un-commenting this line to enable PHP error display

更新代码后，打开终端/命令提示符，然后转到 Magento 的根目录。

cd /path/to/your/magento/directory

然后，要启用开发者模式，需要运行以下命令

php bin/magento deploy:mode:set developer

如果您想检查当前的部署模式，可以使用以下行：

php bin/magento deploy:mode:show

最后，清除缓存：

php bin/magento cache:clean

就是这样。正确执行上述所有步骤后，您将能够在浏览器上看到错误显示。