网站时区配置错误引发白屏问题技术求助

数据老陈

2026-5-28

问题根源

从你的报错日志和代码片段来看，问题非常明确：$CFG->default_timezone这个属性要么没有被定义，要么被设置成了空字符串。这直接引发了连锁错误：

首先PHP抛出Notice，提示该属性未定义
调用date_default_timezone_set('')时，因空时区ID无效再次抛出Notice
最后创建DateTimeZone对象时，空参数直接触发致命异常，导致页面完全白屏

解决方案

这里提供几个递进的修复方案，你可以根据实际情况选择：

1. 修复配置文件（推荐长期方案）

先找到定义$CFG对象的配置文件（通常是项目根目录的config.php或类似命名文件），添加或修正时区配置：

// 替换成你实际需要的时区，比如Asia/Shanghai、UTC、Europe/London等
$CFG->default_timezone = 'Asia/Shanghai';

注意：必须使用PHP支持的有效时区标识符，常见合法值包括UTC、Asia/Shanghai、America/New_York等。

2. 给代码添加容错处理（健壮性优化）

如果担心配置文件可能出现遗漏或错误，可以在common.php的时区代码块里增加判断逻辑，确保即使配置出问题，代码也不会崩溃：

// 先验证时区有效性，无效则兜底使用UTC
$valid_timezone = !empty($CFG->default_timezone) && in_array($CFG->default_timezone, DateTimeZone::listIdentifiers()) 
    ? $CFG->default_timezone 
    : 'UTC';

date_default_timezone_set($valid_timezone);
$dtz = new DateTimeZone($valid_timezone);
$dtz1 = new DateTime('now', $dtz);
$CFG->timezone_offset = $dtz->getOffset($dtz1);

这段代码会先检查配置的时区是否存在且有效，若无效则自动使用UTC作为兜底，彻底避免致命错误导致的白屏。

3. 临时应急修复（不推荐长期使用）

如果一时找不到配置文件，可以直接修改common.php里的代码，把$CFG->default_timezone替换成你需要的时区：

date_default_timezone_set('UTC'); // 直接硬编码时区
$dtz = new DateTimeZone('UTC');
$dtz1 = new DateTime('now', $dtz);
$CFG->timezone_offset = $dtz->getOffset($dtz1);

这个方法能快速恢复页面，但长期来看还是建议修复配置文件，避免硬编码带来的维护麻烦。

内容的提问来源于stack exchange，提问作者nonamewawrsaw