PHP打开网页提示404怎么处理

PHP打开网页提示404错误，本质是服务器无法找到请求对应的资源，需要从文件路径、服务器配置、代码逻辑等多个维度逐步排查，以下是完整的处理方案。

一、先排查基础文件路径问题

最常见的404原因是请求的文件实际不存在，首先确认访问的URL对应的文件路径是否正确。

• 检查URL中的文件名、目录层级是否和实际项目结构一致，注意Linux系统下文件名区分大小写
• 确认文件确实上传到了服务器的对应目录，没有遗漏或者放错位置
• 如果是相对路径访问，确认当前脚本的工作目录是否符合预期，可以通过echo getcwd();输出当前工作目录排查

二、检查服务器伪静态规则配置

很多PHP项目使用伪静态隐藏入口文件或者美化URL，如果伪静态规则配置错误也会触发404。

1. Apache服务器排查

确认项目根目录下是否存在.htaccess文件，规则是否正确，以下是常见的入口文件伪静态规则示例：

<IfModule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>

同时确认Apache是否开启了mod_rewrite模块，未开启的话伪静态规则不会生效。

2. Nginx服务器排查

Nginx需要在站点配置文件中添加对应的伪静态规则，以下是常见配置示例：

location / {
  if (!-e $request_filename) {
    rewrite  ^(.*)$  /index.php?s=$1  last;
    break;
  }
}

修改配置后需要执行nginx -s reload重载配置才能生效。

三、排查PHP代码层面的路由问题

如果是使用框架开发的项目，404可能是路由配置错误导致的。

• 检查框架的路由配置文件，确认请求的URL已经注册了对应的路由规则
• 确认路由对应的控制器和方法存在，没有拼写错误
• 检查是否有中间件或者权限校验逻辑拦截了请求，返回了404响应

可以在入口文件添加调试代码，确认请求是否到达了PHP脚本：

<?php
// 入口文件index.php添加调试
file_put_contents('request.log', date('Y-m-d H:i:s') . ' ' . $_SERVER['REQUEST_URI'] . PHP_EOL, FILE_APPEND);
// 原有框架入口代码
require __DIR__ . '/vendor/autoload.php';
// ... 其他代码

四、检查自定义404处理逻辑

部分项目会自定义404错误页面，如果配置错误也会导致异常。

• 检查PHP代码中是否通过header函数主动返回了404状态码，比如header("HTTP/1.1 404 Not Found");
• 确认服务器配置的自定义404页面路径是否正确，Apache可以在配置中通过ErrorDocument 404 /404.php指定，Nginx可以通过error_page 404 /404.php;指定

五、开启错误提示辅助排查

如果以上步骤都没找到问题，可以临时开启PHP的错误提示，查看是否有隐藏的错误信息：

<?php
// 临时开启错误显示
error_reporting(E_ALL);
ini_set('display_errors', '1');
// 原有业务代码

注意生产环境不要长期开启这个配置，避免暴露敏感信息。

PHP404错误网页路由伪静态error_reporting修改时间：2026-06-19 08:54:22