XAMPP运行PHP项目时新增页面、图片等资源无法正常加载问题
问题排查与修复方案
路由跳转异常(地址栏变但页面不变/空白)
1. 检查Apache伪静态配置
- 查看站点根目录的
.htaccess文件,确认是否存在全局重定向到单入口文件(通常是index.php)的规则,示例如下:
RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php [L]
- 若存在上述规则,说明原项目采用单入口路由架构,不能直接在根目录新建
register.php文件实现访问,需要到项目路由配置文件中新增/register路径与对应页面逻辑的绑定规则 - 若不需要单入口路由,可临时注释重写规则,直接访问
healthone.localhost/register.php测试可用性,验证是否为路由规则导致的问题
2. 空白页定位修复
- 打开PHP错误提示:在XAMPP控制面板点击Apache行的「Config」按钮,选择
php.ini,将display_errors = Off改为display_errors = On,重启Apache后再次访问空白页即可看到具体PHP报错,根据报错定位语法错误、文件引入失败等问题 - 检查文件权限:Windows下确认页面文件未设置只读属性,macOS/Linux下给站点目录设置
755权限,保证Apache进程可正常读取文件 - 核对文件引入路径:页面内
include/require公共文件时优先使用绝对路径,或通过$_SERVER['DOCUMENT_ROOT']拼接路径,避免相对路径写错导致文件加载失败
新增/替换图片无法加载
原有图片可正常加载的前提下,按优先级排查:
- 强制刷新清空浏览器缓存:按
Ctrl+Shift+R(Windows)/Command+Shift+R(Mac)跳过缓存加载资源,或打开浏览器开发者工具「网络」标签,勾选「禁用缓存」后刷新页面 - 核对路径与文件名大小写:确认代码中写的图片路径、文件名的大小写与实际服务器上的文件完全一致,避免大小写不匹配导致访问失败
- 调整伪静态规则排除静态资源:若重写规则未排除静态资源,会将图片请求转发到入口文件导致加载失败,可在
.htaccess的重写规则前添加静态资源跳过规则:
RewriteCond %{REQUEST_URI} !\.(?:css|js|png|jpg|jpeg|gif|webp|ico)$ [NC]
- 验证图片文件完整性:确认新增/替换的图片文件未损坏,文件后缀与实际图片格式匹配,无格式强制修改导致的解析失败问题
内容的提问来源于stack exchange,提问作者Delano Raposo
相关产品推荐
相关产品推荐

