海洋 CMS 网站首页空白该怎么排查

首页空白但后台能进，问题基本出在模板或缓存；前后台一起白屏，先查 PHP 致命错误和数据库连接。按下面六步走，90% 的海洋 CMS 白屏都能在两小时内定位到具体文件。

首页空白、后台正常，是什么原因？

结论：后台能正常打开，说明 PHP 和数据库都没问题，故障点被锁定在首页模板或缓存文件上，优先查这两处。

先删缓存。海洋 CMS 会把首页生成的数据缓存在 /data/cache/ 目录下，缓存文件写入中断（比如磁盘满、进程被 kill）后会留下半截的 PHP 文件，前台一 include 就白屏。操作方式有两种：一是进后台找「清除缓存」按钮点一次；二是直接用命令删，注意保留目录本身：

rm -rf /www/wwwroot/你的站点/data/cache/*

再切模板。把当前模板目录改名，换成官方默认模板，刷新首页。如果换完就正常，说明是你改过的模板里有语法错误，重点检查 index.htm、header.htm、footer.htm 这三个文件，常见的是标签没闭合、{if} 写成了 {if:。

前后台一起空白，第一步该做什么？

结论：第一步是让 PHP 把错误吐出来，没有报错信息就只能在黑暗中猜。

海洋 CMS 很多版本默认关掉了错误显示，所以白屏时页面上什么都没有。临时打开方法：在站点根目录 index.php 的最上面加两行——

ini_set('display_errors', '1');
error_reporting(E_ALL);

或者改 php.ini 里的 display_errors = On，然后重启 PHP 服务（systemctl restart php-fpm 或宝塔面板里点重启）。刷新页面，报错文件路径和行号会直接打在屏幕上。

如果加了还是空白，去看服务器日志：

tail -50 /www/wwwlogs/你的域名.error.log

PHP-FPM 的日志同样会有 PHP Fatal error 记录。日志里出现 Allowed memory size exhausted，就把 memory_limit 从 128M 提到 256M。

PHP 版本不对会导致首页白屏吗？

结论：会，而且这是海洋 CMS 最容易被忽略的白屏原因——这个系统对高版本 PHP 兼容性有限，PHP 8.x 下经常直接白屏，建议切到 PHP 7.4 验证。

排查动作很简单：在宝塔或 AMH 面板里，把站点绑定的 PHP 版本从 8.0/8.1 切到 7.4，清一次缓存再刷新。如果切完立刻恢复，就别再折腾代码了，保持 7.4 运行即可。同理，PHP 5.6 以下的旧版本也可能因为缺少新语法支持而报错。

文件权限和数据库连接怎么检查？

结论：data 目录必须可写，数据库配置错误则会让整站直接白屏，这两项各花一分钟就能排除。

权限命令（把 www 换成你服务器实际的 PHP 运行用户，宝塔默认是 www）：

chown -R www:www /www/wwwroot/你的站点
chmod -R 755 /www/wwwroot/你的站点
chmod -R 777 /www/wwwroot/你的站点/data

数据库方面，打开 /data/common.inc.php，核对 dbhost、dbuser、dbpass、dbname 四项。用命令行验证一次最快：

mysql -u用户名 -p密码 -e "use 数据库名; show tables;"

连不上就先解决 MySQL 服务或密码问题，跟 CMS 本身无关。

伪静态规则写错会让首页变空白吗？

结论：会。首页的 rewrite 规则把请求转发到了不存在的 PHP 文件时，返回的就是空白页而不是 404。

最快的验证方法是临时停用伪静态：Nginx 环境下，把站点配置里 include 的那条 rewrite 规则注释掉，nginx -t 测试通过后 nginx -s reload，直接访问 /index.php。如果这时首页正常，说明是伪静态规则的问题，重新粘贴海洋 CMS 官方提供的那份规则即可。另外确认根目录下没有残留的 index.html，静态首页会盖掉 index.php。

最后按「缓存 → 模板 → 报错日志 → PHP 版本 → 权限与数据库 → 伪静态」这个顺序走一遍，每改一步就清一次 /data/cache/，避免旧缓存干扰判断，基本不会绕远路。