宝塔面板关闭错误提示方法

学完这篇，你能在宝塔面板上安全关闭网站前台显示的 PHP 错误提示，避免路径、数据库账号等敏感信息泄露，同时保留日志方便排查问题。

第一步：确认错误提示属于哪种类型

这一步要弄清你看到的是 PHP 报错还是面板自身弹窗，避免改错地方。如果网站页面顶部出现 Warning: include(): Failed opening... 或 Fatal error: Uncaught...，就是 PHP 错误显示。本文以宝塔 Linux 面板 8.0.5 为例，Windows 面板菜单类似。

第二步：全局关闭所有站点的 PHP 错误显示

这一步通过修改 PHP 配置，让所有使用该 PHP 版本的站点都不再向前台输出错误。登录宝塔面板，点左侧「软件商店」→「已安装」，找到正在用的 PHP 版本（如 PHP-7.4），点右侧「设置」→「配置修改」。在搜索框输入 display_errors，把 display_errors = On 改成 display_errors = Off。如果行首有分号 ;，一并去掉。点「保存」，再点「重载配置」。

注意：不要同时把 error_reporting 设为 0，否则错误日志也不会记录。保留 error_reporting = E_ALL 即可，错误会写入 /www/wwwlogs/php-fpm.log 或站点日志。

第三步：只关闭某个站点的错误提示

这一步针对多站点环境，不影响其他网站。进入宝塔「文件」→ 打开 /www/wwwroot/你的域名/ 目录，新建文件 .user.ini，写入一行：display_errors = Off 保存。然后回到「软件商店」→ PHP 设置→「重载配置」。.user.ini 默认缓存 300 秒，重载后立即生效。

注意：如果站点根目录已有 .user.ini，直接编辑添加该行，不要覆盖原有内容。部分旧版宝塔需在「网站」→ 站点→「设置」→「配置文件」中确认 user_ini.filename = .user.ini 已开启。

第四步：关闭 WordPress 等程序的调试模式

这一步解决程序自身强制显示错误的问题。如果网站是 WordPress，用宝塔「文件」打开站点根目录的 wp-config.php，找到 define('WP_DEBUG', true); 改为 false。如果没有这行，在 /* That's all, stop editing! */ 上方添加：

define('WP_DEBUG', false);
define('WP_DEBUG_DISPLAY', false);

保存即可。ThinkPHP 则检查 config/app.php 中的 app_debug 改为 false。

注意：修改 wp-config.php 前先右键下载备份，改错会导致网站白屏。

第五步：关闭宝塔面板自身的错误通知（可选）

这一步只针对面板右上角弹出的红色错误提醒。点面板左上角「设置」→「通知设置」，取消勾选「面板错误」和「系统消息」，点「保存」。部分版本在「面板设置」→「消息通知」里操作。

小结

• 全局关闭：软件商店 → PHP 设置 → 配置修改 → display_errors = Off。
• 单站关闭：网站根目录新建 .user.ini 写入 display_errors = Off，重载 PHP。
• 程序层面：WordPress 关 WP_DEBUG，ThinkPHP 关 app_debug。
• 关闭显示不等于关闭日志，错误仍会记录在 /www/wwwlogs/ 下。
• 每次修改前备份原文件，改完重载配置。