宝塔面板使用时如何开启调试模式？

一、什么是宝塔面板调试模式？

调试模式是宝塔面板提供的一个开发者功能，开启后会显示详细的错误日志和系统运行信息，主要用于排查面板运行异常、插件冲突或系统配置错误等问题。该模式会输出底层PHP错误、SQL查询等敏感信息，建议仅在排查问题时临时启用。

二、通过配置文件开启调试模式

这是最常用的开启方式，操作步骤如下：

1. 登录服务器SSH终端
2. 定位到宝塔面板配置文件路径：

   /www/server/panel/config/config.json

3. 使用vim或nano编辑该文件：

   vim /www/server/panel/config/config.json

4. 找到或添加以下配置项：

   {
       "debug": true,
       "develop": true
   }

5. 保存文件后重启面板服务：

   bt restart

三、通过命令行快速开启

宝塔面板6.0+版本提供了快捷命令：

bt debug

执行后会显示以下选项菜单：

1. 开启调试模式
2. 关闭调试模式
3. 查看当前状态

输入1并回车即可立即开启，无需手动修改配置文件。

四、调试模式的安全注意事项

1. 调试信息可能包含数据库密码等敏感数据，开启后务必不要公开访问面板
2. 建议通过防火墙限制仅允许特定IP访问面板端口
3. 问题解决后应立即关闭调试模式：

   bt debug off

   或手动将配置文件的debug和develop改为false

4. 生产环境不建议长期开启调试模式

五、调试信息的查看与分析

开启调试模式后，可以通过以下途径获取信息：

• 面板页面底部会显示SQL查询和加载时间
• 错误日志路径：

  /www/server/panel/logs/error.log

• 操作日志路径：

  /www/server/panel/logs/request.log

• 实时监控日志：

  tail -f /www/server/panel/logs/error.log

六、常见问题解决

Q：开启调试模式后页面显示空白？
A：可能是配置文件格式错误，检查json文件语法或执行bt 16修复面板

Q：调试信息过多影响查看？
A：可通过修改/www/server/panel/config/config.json中的level参数调整日志级别

Q：如何区分开发环境和生产环境配置？
A：建议创建config_dev.json和config_prod.json两个配置文件，通过符号链接切换