Discuz 安装后首页 500 错误通常由 PHP 配置错误或文件权限不足导致，优先查看服务器错误日志定位具体报错信息。适用场景为全新安装或迁移后的环境，风险边界在于不要直接开放生产环境的错误显示。
先说结论：500 错误是服务器内部错误，核心原因集中在 PHP 版本兼容性、目录写入权限和数据库连接配置。
- 先确认 PHP 版本是否在 Discuz 支持范围内
- 先处理 data 和 config 目录的写入权限
- 再验证错误日志是否记录具体异常
命令速用版
以下命令用于快速检查环境状态和日志，需在服务器 SSH 终端执行。
# 查看 PHP 版本
php -v
# 查看最近 50 行 PHP 错误日志
tail -n 50 /www/server/php/74/var/log/php_error.log
# 检查 Discuz 数据目录权限
ls -ld /www/wwwroot/your_site/data
# 临时赋予写入权限（测试用，完成后需收回）
chmod -R 777 /www/wwwroot/your_site/data为什么会这样
500 错误代表服务器内部脚本执行失败，Discuz 默认关闭错误显示导致页面只返回状态码。
PHP 脚本在初始化阶段遇到致命错误（Fatal Error）时会中断执行，服务器无法返回正常 HTML 内容。常见触发点包括数据库连接失败、必需 PHP 扩展缺失、或关键配置文件无法读取。Discuz 为了安全默认不显示详细错误信息，因此浏览器端只能看到通用的 500 Internal Server Error。
分步处理
按顺序执行以下步骤，每步完成后刷新页面观察变化。
第一步：开启 PHP 错误显示
在 php.ini 或网站根目录 .htaccess 中设置 display_errors = On。修改后重启 PHP 服务，刷新首页查看是否显示具体错误信息。操作完成后务必关闭该选项，避免泄露路径信息。
第二步：检查目录权限
确认 data、config、uc_client/data 目录具有写入权限。Linux 环境下通常设置为 755 或 777（测试期间）。使用命令 chmod -R 755 ./data 进行修正。权限不足会导致缓存文件无法生成，引发 500 错误。
第三步：核对 PHP 版本
Discuz! X3.4 和 X3.5 在 PHP 7.4 及以下版本兼容性最好。PHP 8.0 及以上版本可能存在函数废弃导致的报错。如果服务器使用 PHP 8+，尝试切换至 PHP 7.4 环境测试。
第四步：检查数据库配置
打开 config/config_global.php 文件，核对 $_config['db']['1']['dbhost'] 等参数。确保数据库用户名、密码和主机地址正确。数据库连接失败通常会直接导致脚本终止。
怎么验证是否生效
刷新浏览器首页，状态码变为 200 且页面正常加载即为生效。
检查服务器错误日志文件，确认不再新增新的 Fatal Error 记录。观察 Discuz 后台管理中心能否正常登录，部分权限问题仅在访问特定模块时触发。如果日志停止更新且页面访问正常，说明故障已排除。
常见坑
生产环境长期开放 777 权限会导致安全风险，测试完成后应恢复为 755。
PHP 8.0 以上版本默认废弃了部分旧函数，Discuz 旧版本代码未适配时会报错。不要盲目升级 PHP 版本，应先确认 Discuz 版本说明。伪静态规则配置错误也可能引发 500，排查时可暂时关闭伪静态测试。
常见问题
数据库连接错误会显示 500 吗？
会，数据库连接失败属于致命错误，默认配置下会触发 500 状态码。
页面白屏和 500 错误有什么区别？
白屏通常是 PHP 执行完毕但无输出，500 错误是服务器明确返回的状态码，两者排查方向一致。
安装锁文件会影响首页访问吗？
会，data/install.lock 文件存在时禁止重复安装，缺失或权限错误可能引发初始化异常。