Discuz 论坛首页空白通常由 PHP 错误被隐藏或文件权限配置错误导致，最推荐的处理方向是临时开启调试模式查看具体报错信息。适用场景为 Discuz! X 系列版本搭建初期或更新后，风险边界是调试完成后必须关闭调试开关以防信息泄露。

快速处理思路

直接修改配置文件开启调试，无需执行 Shell 命令，但需确保有文件编辑权限。

文件路径：/config/config_global.php
查找：$_config['debug']
修改为：$_config['debug'] = 1;

如果无法编辑文件，检查服务器错误日志作为替代方案。

为什么会这样

生产环境默认关闭 PHP 错误显示以避免泄露敏感信息，导致致命错误只记录不展示。Discuz 程序遇到未捕获异常时停止执行，浏览器接收不到完整 HTML 内容从而显示空白。常见诱因包括数据库连接失败、缺少 PHP 扩展或文件权限不足。

分步处理

按顺序执行以下操作，每步完成后刷新首页观察变化。

步骤 1：检查服务器错误日志
动作：登录服务器查看 Nginx 或 Apache 错误日志，以及 PHP 错误日志。
检查点：日志中是否有 "Fatal error" 或 "Parse error" 关键字。
风险边界：只读操作，无风险。

步骤 2：开启 Discuz 调试模式
动作：使用 FTP 或文件管理器打开 config/config_global.php。
配置片段：将 $_config['debug'] 的值从 0 改为 1。
风险边界：调试结束后必须改回 0，否则暴露网站路径和数据库信息。

步骤 3：检查文件权限
动作：确认 data 目录和 config 目录 writable 权限。
检查点：Linux 环境下 data 目录权限建议为 755 或 777（测试后改回 755）。
风险边界：777 权限存在安全风险，仅限调试使用。

步骤 4：检查数据库连接
动作：打开 config/config_global.php 核对数据库账号密码。
检查点：确认 DB 主机名、端口、用户名、密码无误。
风险边界：修改配置前建议备份原文件。

怎么验证是否生效

刷新论坛首页，观察页面表现变化。

验证成功标志 1：页面显示具体 PHP 错误信息，如 "Call to undefined function" 或 "Database access denied"。

验证成功标志 2：页面正常加载，显示论坛首页内容。

验证成功标志 3：data/log/ 目录下生成新的错误日志文件，记录时间戳与当前一致。

调试完成后，务必将 $_config['debug'] 改回 0 并刷新页面确认不再显示错误详情。

常见坑

1. PHP 版本不兼容：Discuz! X3.4 及以后版本对 PHP 7.4+ 支持较好，过低或过高版本可能导致函数缺失。
2. 缓存文件冲突：data/cache/ 目录下的旧缓存文件可能导致加载失败，可尝试删除该目录下非 index.html 文件。
3. 编码问题：配置文件保存格式必须为 UTF-8 无 BOM 格式，否则可能导致解析错误。
4. 伪静态规则错误：Nginx 或 Apache 伪静态规则配置错误可能导致首页请求被错误拦截，暂时关闭伪静态测试。

常见问题

安装完成后首页空白怎么办

优先检查数据库连接配置是否正确，确认数据库用户有权限访问指定库。

升级 Discuz 版本后出现白屏

通常因缓存文件不兼容导致，建议清空 data/cache 目录并更新缓存。

开启调试模式后仍然没有错误提示

检查 php.ini 中 display_errors 是否开启，或查看服务器错误日志而非页面输出。