核心排查与修复步骤
按以下顺序操作，无需额外工具，零门槛落地，从定位错误到彻底修复：
1. 开启PHP错误日志定位具体原因
PHP默认屏蔽错误导致空白页，需开启错误日志精准定位：
- 执行命令
php -i | grep php.ini，找到当前PHP的php.ini文件路径；
- 打开php.ini，修改2个核心配置项：display_errors = On、error_reporting = E_ALL；
- 保存后重启PHP服务：Nginx+PHP-FPM执行
systemctl restart php-fpm，Apache+PHP执行systemctl restart httpd；
- 刷新EyouCMS页面，查看浏览器或PHP日志文件中的具体错误提示。
2. 开启EyouCMS调试模式定位框架错误
若PHP日志无提示，开启EyouCMS框架级调试模式：
- 找到EyouCMS根目录下的入口文件
public/index.php；
- 找到定义行：define('APP_DEBUG', false);，将false改为true；
- 刷新页面，将显示框架级具体错误，如数据库连接失败、类不存在、语法错误等。
3. 检查PHP版本兼容性
EyouCMS对PHP版本有严格要求，版本不匹配直接导致空白页：
- 执行命令
php -v查看当前PHP版本；
- 官方要求：EyouCMS 1.6+支持PHP7.2-8.1，1.5及以下版本支持PHP5.6-7.4；
- 版本不符处理：宝塔面板用户在「软件商店」→「已安装」→「PHP」→「设置」切换对应版本；LNMP/LAMP用户执行
lnmp switch php7.4（按需替换为符合要求的版本号）。
4. 修复目录权限与所有权
EyouCMS的运行目录需Web服务器拥有读写权限，权限错误是高频诱因：
- 进入EyouCMS根目录，命令：
cd /var/www/html/eyoucms（按实际部署路径修改）；
- 执行权限命令：chmod -R 755 runtime public/upload；
- 执行所有权命令：chown -R www:www runtime public/upload（Web用户为www，按需替换）；
- 宝塔面板用户直接选中对应目录，右键「修改权限」，勾选「递归包含子目录」后提交。
5. 核对数据库配置
数据库连接错误会直接返回空白页，需精确核对配置：
- 打开EyouCMS根目录下的
application/database.php文件；
- 核对以下完整配置，确保无多余空格或错误：
```
return [
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' => '127.0.0.1',
// 数据库名
'database' => 'eyoucms',
// 用户名
'username' => 'root',
// 密码
'password' => '你的数据库密码',
// 端口
'hostport' => '3306',
// 数据库表前缀
'prefix' => 'ey_',
];
```
- 重点检查password字段，避免复制时带入多余字符。
6. 排查模板或插件冲突
模板修改或第三方插件冲突会导致页面资源加载失败，操作如下：
- 将
public/theme下的当前模板文件夹临时重命名（如改为theme_bak）；
- 将
plugins目录下的所有插件临时移走（如移到plugins_bak）；
- 刷新页面，若页面正常，说明冲突来自模板或插件，逐个排查后恢复即可。
7. 修复后回滚调试配置
调试完成后需恢复配置，避免生产环境安全风险：
- 将public/index.php中的APP_DEBUG改回false；
- 生产环境禁止保留调试模式，防止敏感信息泄露。
