You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

PHP项目从GitHub部署后浏览器显示白页求助

PHP Pick'em 白页问题排查步骤
  • 检查PHP错误日志
    白页大多是PHP报错但未对外显示,找到服务器的PHP错误日志(如Apache的error.log、Nginx关联的php-fpm.log),日志里会记录具体报错原因,比如数据库连接失败、文件权限不足、代码语法错误。

  • 临时开启PHP错误显示
    在项目入口文件(比如index.php)顶部添加以下代码,强制页面显示错误信息:

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

    刷新页面后就能看到具体问题,排查完成后记得移除这段代码。

  • 核对数据库配置
    找到项目中的数据库配置文件(通常是config.php或db.php),检查主机地址、用户名、密码、数据库名称是否和你安装时的设置完全一致,注意拼写和大小写。

  • 检查文件与目录权限
    确保PHP进程能读取项目文件、写入必要的目录(如缓存、日志目录)。一般建议目录权限设为755,文件权限设为644。

  • 查看浏览器控制台报错
    按F12打开浏览器开发者工具,切换到「控制台」标签,检查是否有JS、CSS等资源加载失败(404错误)或JS执行报错的信息。

  • 确认服务器根目录配置
    检查服务器的网站根目录是否指向项目的正确入口目录(比如部分项目需要指向public目录),避免因入口文件不对导致的白页。

内容的提问来源于stack exchange,提问作者Kevin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.19 19:04:52