404 是 Web 服务器找不到文件路径所致,非 PHP 报错;需依次验证 PHP 解析是否生效、检查 .htaccess 重写规则是否误拦截真实 PHP 文件、确认上传路径与虚拟主机文档根目录一致,并排除大小写及隐藏字符问题。

404 不是 PHP 报错,而是 Web 服务器(如 Apache 或 Nginx)说“我根本没找到你要的这个文件路径”。在虚拟主机环境下,你没有 root 权限改全局配置,排查必须聚焦在你能控制的层面:文件位置、URL 路径、.htaccess、以及服务商是否真支持 PHP 解析。
确认 PHP 文件是否被当作静态文件直接返回
这是虚拟主机最隐蔽的坑:有些廉价主机默认不解析 .php 文件,而是把它当普通文本下载或拒之门外,浏览器一请求就 404(甚至不报错,只空白)。
快速验证:
- 新建一个
info.php,内容只有 - 上传到你网站根目录(比如
public_html或www) - 用浏览器访问
http://你的域名/info.php—— 如果看到 PHP 信息页,说明解析正常;如果下载文件、显示源码、或直接 404,那问题出在服务器未启用 PHP 处理
application/x-httpd-php 还是 CGI/FastCGI)。检查 .htaccess 是否偷偷劫持了所有请求
很多虚拟主机默认允许 .htaccess,而 CMS(如 WordPress、Typecho)或手动加的伪静态规则常包含兜底重写:
RewriteEngine On这类规则本意是把所有“找不到的真实文件”转给
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
index.php,但它有个漏洞:如果 about.php 真实存在,按理应跳过重写——但某些虚拟主机的 Apache 模块版本或 AllowOverride 配置异常,会导致 !-f 判断失效,结果连真实 PHP 文件也被转发,而 index.php 又没处理它,最终 404。解决方法:
- 临时把
.htaccess重命名为.htaccess.bak - 刷新
/about.php,能打开就坐实是它的问题 - 修复规则:在重写前加放行段(注意顺序!):
RewriteEngine On
# 显式放行真实存在的 .php 文件
RewriteCond %{REQUEST_FILENAME} -f
RewriteCond %{REQUEST_FILENAME} \.php$
RewriteRule ^ - [L]
# 其余路由逻辑保持不变
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
核对虚拟主机的文档根目录与你上传路径是否一致
虚拟主机控制面板(如 cPanel)里写的“网站根目录”未必是你直觉认为的那个路径。例如:
- 你买的是子域名
blog.abc.com,它的根目录可能是public_html/blog/,而不是public_html/ - 某些主机为安全起见,把 Web 可访问目录设为
public/或htdocs/,而你传到了上级文件夹 - FTP 登录后看到的第一个目录不一定是 Web 根,得看控制面板「Addon Domains」或「Subdomains」页面里明确标注的 “Document Root”
- 登录 cPanel → 找「File Manager」→ 切换到“Web Root”视图,看当前高亮路径
- 或者进「Domains」→ 点击对应域名 → 查 “Document Root” 字段值
- 确保你的
index.php就在这个路径下,且 URL 中的路径层级完全匹配(http://blog.abc.com/test.php对应的就是public_html/blog/test.php)
立即学习“PHP免费学习笔记(深入)”;
别忽略大小写和隐藏字符这种“低级错误”
Linux 虚拟主机严格区分大小写,About.php 和 about.php 是两个文件。
更难发现的是不可见字符:复制粘贴 URL 时可能混入全角斜杠 /、中文顿号、零宽空格(尤其从微信、Word 里复制过来),浏览器地址栏看着一样,服务器却完全识别不了。
务必:
- 在记事本或 VS Code 纯文本模式下重新手打 URL
- 检查 FTP 客户端是否显示文件名含空格或特殊符号(比如
contact .php) - 用命令行(如有 SSH)执行
ls -la确认文件名原貌
虚拟主机的限制决定了你无法像本地环境那样改 httpd.conf 或重启服务,所有排查必须落在“上传了什么”“写了什么规则”“路径对不对”这三件事上。最容易被跳过的其实是第一步:先确认 PHP 解析本身是否生效——很多所谓“404”,本质是服务器压根没跑 PHP 引擎。











