问题概述
在浏览器输入后台地址、账号密码后点登录，页面跳转到 login.php 后却是纯白屏，F12 控制台也看不到任何 HTML 输出。这是织梦CMS迁移或升级后最常见的问题之一，常出现在 PHP 版本切换、目录权限变更、数据库连接异常等场景。
原因分析
1. PHP 版本过高导致函数废弃
织梦 V5.7 SP2 之前的核心代码大量使用 mysql_connect()、session_register() 等已在 PHP 7+ 移除的函数。一旦服务器升级到 PHP 7 或 8，登录页会直接白屏。
2. data 目录缓存损坏
data/sessions/ 目录不存在或不可写，导致 session 写入失败，登录后无法保存状态，页面静默退出。
3. 数据库连接信息错误
data/common.inc.php 中的数据库主机、账号、密码不正确，或数据库端口被防火墙拦截，都会让 login.php 在连接阶段直接终止。
4. BOM 头与空白字符
用 Windows 记事本编辑 PHP 文件后保存为 UTF-8 with BOM，会让 header() 之前产生输出，导致跳转失败出现空白。
5. 磁盘空间不足或 Zend 加载失败
服务器磁盘满了、Zend Guard Loader 未安装，加载加密文件 include/common.inc.php 时直接报错被吞掉。
排查步骤
步骤一：开启 PHP 错误显示
在 index.php 或 login.php 顶部临时加入：
ini_set('display_errors', 1);
error_reporting(E_ALL);再次访问，白屏会变成具体的错误信息。
步骤二：核对 PHP 版本
宝塔「网站 - PHP版本」切换回 5.6 或 7.0，看是否恢复正常。如果必须用 PHP 7/8，需要打「织梦 PHP7 适配补丁」。
步骤三：检查 data 目录权限
确保以下目录存在且可写：
data/sessions
data/cache
data/mark
data/module
data/tplcache步骤四：验证数据库连接
新建 test.php 测试数据库：
<?php
$link=@mysqli_connect('localhost','root','password','dedecms');
if(!$link){ die(mysqli_connect_error()); }
echo 'ok';
?>步骤五：清理 BOM 头
使用 Notepad++ 或 VSCode 将所有 PHP 文件另存为「UTF-8 无 BOM」格式。
常见配置示例
正确的 data/common.inc.php 应当如下：
<?php
$cfg_dbhost='localhost';
$cfg_dbname='dedecmsv57';
$cfg_dbuser='root';
$cfg_dbpwd='yourpwd';
$cfg_dbprefix='dede_';
$cfg_db_language='utf8';
?>注意结尾不要有任何空行或空格。
注意事项
- 排查完成后务必关闭
display_errors，避免错误信息泄露数据库结构。 - 升级到 PHP 8 后，织梦部分核心代码仍依赖
each()、create_function()，需要替换为foreach与匿名函数。 - data 目录权限不要设为 777，建议 755 并归属 www 用户。
- 定期备份
data/common.inc.php与data/config.cache.inc.php，避免误改后无法回滚。
后续行动指引
解决白屏问题后，建议站长对站点做一次完整健康检查：核对 PHP 版本与织梦版本兼容性、清理冗余缓存文件、规范 data 目录权限。如果站点长期使用，建议升级到织梦 V5.7 SP3 或迁移到基于 PHP 8 的二次开发分支，从根本上避免老旧代码风险。把本次排查过程记录到运维文档中，下次遇到同类问题就能直接复用方案。