我的知识记录

PHP 网站打开空白一片?手把手排查教程

PHP 网站打开后空白(俗称“白屏”),是新手最常遇到的问题之一——没有报错提示、没有加载内容,只显示空白页面,让人无从下手。其实核心原因只有两类:PHP 代码报错但未显示服务器/环境配置异常
本教程按「从简单到复杂、从本地到服务器」的顺序,手把手教你排查,全程无需复杂工具,新手也能轻松操作。
 
先排除最基础、最常见的问题,避免白费功夫。

1. 排查浏览器缓存/强制刷新

有时浏览器缓存会导致页面显示异常,尤其是修改过代码后。操作方法:
  • Chrome/Firefox:按 Ctrl+F5(强制刷新,跳过缓存);
  • Edge:按 Ctrl+Shift+R
  • 若仍空白,打开浏览器「无痕模式」重新访问,排除缓存和插件干扰。

2. 排查文件路径与文件名(大小写敏感!)

PHP 对文件路径、文件名的大小写敏感(尤其是 Linux 服务器),这是新手最容易忽略的点:
  • 确保访问的 URL 正确(比如想访问 index.php,不能写成 Index.php 或 index.PHP);
  • 检查网站根目录是否正确(比如 Apache/Nginx 配置的根目录,是否指向了你的 PHP 文件所在文件夹);
  • 若页面依赖其他文件(如 include/require 引入的文件),确保引入路径正确(相对路径、绝对路径都可,推荐绝对路径避免出错)。

3. 排查PHP文件是否存在且可读取

确认你要访问的 PHP 文件(如 index.php)确实存在于服务器/本地环境的对应目录,且文件权限正确:
  • 本地环境(XAMPP/WAMP):直接打开对应文件夹,确认文件存在;
  • 服务器(Linux):通过 FTP 或宝塔面板,查看文件权限,一般设置为 644(文件)、755(文件夹),避免权限不足导致无法读取。

PHP 网站打开空白一片?手把手排查教程

标签:

更新时间:2026-03-12 10:54:13

上一篇:访问网站或操作后台时,提示“未知方法或属性”,无法执行对应操作

下一篇:网站页面空白、提示“PHP 版本过低”“数据库版本不兼容”或直接无法进入安装界面