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(文件夹),避免权限不足导致无法读取。

更新时间:2026-03-12 10:54:13
上一篇:访问网站或操作后台时,提示“未知方法或属性”,无法执行对应操作
