调试模式

常见问题

调试模式

最后更新时间：2022-06-14 10:19:21

#### 说明

1. 当遇到系统报错或者不正常跳转时，可尝试开启调试模式，查看是否有报错信息，根据报错信息做相应处理

2. 调试模式仅为开发人员测试、排查问题，或部署阶段测试使用，正式上线前请及时关闭该模式

3. 当后台可以正常访问，需要调试时建议使用后台开启调试方式，如无法进入后台开启调试再使用文件开启调试。

#### 使用方法

##### 【1】后台开启调试

位置：登录后台，【系统】-【全局设置】-【安全】，点击开启，输入允许调试的IP。调试过程结束后，应在此处关闭即可。

![](https://upload.apayun.com/2021/09/6142eaf39d526.jpg?token=iCc5_nqKuFCpiHDIaDkbHA&expires=1714118886)

开启调试后，会有如下提示，关闭调试后消失。

![](https://upload.apayun.com/2020/12/5fe9ae72a4e26.png?token=fp56anqMaSxE62mARO51GQ&expires=1714118886)

##### 【2】文件开启调试

登录服务器进入站点根目录，找到 index.php 找到 define('APP_DEBUG_SAFE', false) ，修改为 define('APP_DEBUG_SAFE', true) 即可开启调试。

![](https://upload.apayun.com/2020/12/5fea8345e9915.png?token=196ELvjOxUh04EHcsmKwqg&expires=1714118886)

开启调试后，提示为 index.php 文件开启调试，需修改站点目录下的 index.php 找到 `define('APP_DEBUG_SAFE', true)` ，修改为 `define('APP_DEBUG_SAFE', false)` 即可关闭。

![](https://upload.apayun.com/2020/12/5fe9ae80f220f.png?token=n-PBPsb3FEc0qUf9ftMDeQ&expires=1714118886)

#### 常见报错

调试模式开启后将可查看到具体的报错信息，下面列举几种常见的错误：

1. 下图为数据库连接错误，请检查数据库账户密码是否正确和账户权限是否正确赋予

![](https://upload.apayun.com/2019/05/5ceba12313eaf.png?token=IZ3eZoMpgFKT6xvC2E4guw&expires=1714118886)

2. 下图为数据库无法连接，请检查MySQL是否正常运行

![](https://upload.apayun.com/2019/05/5ceba12c883b6.png?token=8YAGGTJuXM5s_YkIwYWjWA&expires=1714118886)

3. 下图的Runtime为缓存文件夹，需赋予app目录写入的权限

![](https://upload.apayun.com/2019/05/5ceba13493315.png?token=39csVAjbZHtesrANKUZdEg&expires=1714118886)

文档首页