404根本原因是Web服务器未找到匹配路由或文件,而非PHP直接返回;常见于URL参数名不一致、伪静态规则错误、Nginx/Apache配置遗漏$query_string或[QSA]导致$_GET为空、框架路由绑定失败及重定向路径拼接错误。

URL路由与PHP传参不匹配导致404
PHP本身不会直接返回404,真正触发404的是Web服务器(如Nginx或Apache)在找不到对应路由或文件时的行为。常见场景是:你写了 index.php?user_id=123,但服务器配置把所有非静态资源都转发给 index.php,而你的PHP代码没正确解析 $_GET['user_id'],或前端发错URL(比如拼成 index.php?userid=123),后端却只读 $_GET['user_id']——这时逻辑失败,若又没做兜底响应,可能被误判为“路径不存在”。
- 检查浏览器地址栏实际请求的URL,确认参数名、大小写、是否多空格或中文编码问题(如
%E4%BD%A0%E5%A5%BD未被urldecode()处理) - 用
var_dump($_GET);
在入口脚本顶部立刻输出,看参数是否抵达PHP层;如果为空,问题出在Web服务器转发或客户端请求环节 - Apache用户注意
.htaccess中的RewriteRule是否错误截断了查询字符串(缺[QSA]标志会导致原有?a=1&b=2丢失) - Nginx用户检查
try_files指令,典型错误写法:try_files $uri $uri/ /index.php;
应改为try_files $uri $uri/ /index.php?$query_string;
,否则$_GET全为空
框架路由中参数名与控制器方法签名不一致
用Laravel、ThinkPHP等框架时,404常因路由定义和接收方式对不上。比如定义了 /user/{id},但控制器方法写成 function show($uid),框架无法绑定,直接抛404。
- Laravel中确保路由参数名和方法形参名完全一致:
Route::get('/post/{slug}', [PostController::class, 'show']);对应public function show($slug) { ... },不能写成$id - ThinkPHP6默认支持变量名映射,但开启严格模式后会校验,检查配置项
url_param_type和url_convert - 自定义路由解析时,避免手动用
explode('/', $_SERVER['REQUEST_URI'])截取参数——路径含斜杠或编码字符时极易出错,优先用框架原生路由机制
伪静态规则写错,让带参URL被当成不存在的静态路径
为了SEO把 article.php?id=100 改成 /article/100.html,但重写规则漏掉关键部分,导致服务器真去查这个HTML文件,自然404。
- Apache示例(正确):
RewriteRule ^article/([0-9]+)\.html$ article.php?id=$1 [L]
;错误写法如漏转义点号:^article/([0-9]+).html$,会被正则误匹配任意字符 - Nginx示例(正确):
rewrite ^/article/(\d+)\.html$ /article.php?id=$1 last;
;若写成rewrite ^/article/(\d+).html$ ...,点号未转义,.html就变成“任意字符+html”,匹配失控 - 上线前用
curl -I http://yoursite/article/100.html看返回状态码,别只依赖浏览器刷新
PHP内部跳转或header重定向时路径拼接错误
代码里用 header('Location: /user/profile?id=' . $id) 跳转,但 $id 为空、含非法字符,或目标路径根本不存在,服务器找不到该URL,最终返回404(尤其是当重定向目标被Web服务器判定为无效路径时)。
立即学习“PHP免费学习笔记(深入)”;
- 重定向前必须校验变量:
if (isset($id) && is_numeric($id) && $id > 0) { header('Location: /user/profile?id=' . (int)$id); exit; } - 避免拼接绝对路径时漏前导斜杠,
'user/profile'和'/user/profile'在不同上下文含义不同;建议统一用完整路径或基于$_SERVER['HTTP_HOST']构造 - 不要依赖
$_SERVER['REQUEST_URI']做跳转来源判断——它可能被篡改或含未解码字符,导致构造的新URL非法
$query_string 传递和Apache的 [QSA] 标志,这两个点一错,$_GET 就全军覆没,后面所有PHP逻辑都无从谈起。











