贝利信息

PHP路由配置错致404怎么办_PHP路由404错误修正办法【策略】

日期:2026-01-18 00:00 / 作者:蓮花仙者
Apache的.htaccess重写规则未生效,主因是mod_rewrite未启用、AllowOverride未设为All、.htaccess位置或内容错误;Nginx需正确配置try_files兜底至index.php;框架路由未注册、中间件拦截、子目录部署时RewriteBase或location路径不匹配也会导致404。

Apache 的 .htaccess 重写规则没生效

PHP 应用(如 Laravel、ThinkPHP)依赖 Apache 的 URL 重写把请求统一交给 index.php 处理,若返回 404,大概率是重写模块未启用或规则被忽略。

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]

注意:部分 PHP 框架(如 CodeIgniter)依赖 index.php/xxx 路径格式,而 Laravel 默认用 index.php?/xxx;路径分隔符差异会导致 404,需按框架文档核对。

Nginx 的 try_files 配置漏掉 index.php

Nginx 不支持 .htaccess,所有路由转发必须在 server 块中显式声明。404 常因 try_files 没把请求兜底到 index.php

PHP 框架自身路由未注册或中间件拦截

Web 服务器转发成功后仍 404,说明请求抵达了 PHP,但框架没匹配到任何路由。常见于开发环境手动改过路由文件却忘了加载,或中间件提前终止了流程。

子目录部署时路由前缀没对齐

把 PHP 应用放在二级路径(如 https://example.com/myapp/)下运行,但路由配置仍按根目录设计,所有生成的 URL 和重写规则都会偏移,导致 404。

最易被忽略的是:Web 服务

器配置和框架路由前缀必须严格一致,差一个斜杠或大小写都可能让重写失败——别只盯着 PHP 代码,先确认请求到底有没有进到 index.php