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，大概率是重写模块未启用或规则被忽略。
- 确认
mod_rewrite已启用：a2enmod rewrite（Ubuntu/Debian），然后重启 Apache：systemctl restart apache2 - 检查虚拟主机配置中是否允许覆盖：
AllowOverride All必须出现在对应None -
.htaccess文件需放在 Web 根目录（如/var/www/html），且内容至少包含标准重写逻辑：
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。
- 典型错误配置：
try_files $uri $uri/ =404—— 这会直接返回 404，跳过 PHP 入口 - 正确写法（Laravel 场景）：
try_files $uri $uri/ /index.php?$query_string; - ThinkPHP 伪静态常用：
try_files $uri $uri/ /index.php?s=$uri&$args; - 确保
fastcgi_pass指向正确的 PHP-FPM socket 或端口，否则即使路由匹配也会 502，但表面像 404
PHP 框架自身路由未注册或中间件拦截
Web 服务器转发成功后仍 404，说明请求抵达了 PHP，但框架没匹配到任何路由。常见于开发环境手动改过路由文件却忘了加载，或中间件提前终止了流程。
立即学习“PHP免费学习笔记（深入）”；
- Laravel 中检查
routes/web.php是否有对应Route::get('/xxx', ...)，且未被Route::middleware(...)里的权限逻辑 return 了空响应 - ThinkPHP 6+ 使用多应用模式时，
route/app_name/route.php路径写错或未在config/app.php的app_map中声明，会导致整个应用路由不加载 - 开启框架调试模式（如 Laravel 的
APP_DEBUG=true）能暴露真实路由列表，用php artisan route:list查看实际注册的路由是否含目标路径
子目录部署时路由前缀没对齐
把 PHP 应用放在二级路径（如 https://example.com/myapp/）下运行，但路由配置仍按根目录设计，所有生成的 URL 和重写规则都会偏移，导致 404。
- Apache 下需在
.htaccess中加RewriteBase /myapp/，否则^.*$匹配的是完整 URI，重写目标会多出一层路径 - Nginx 下，
location块要精确匹配子路径：location /myapp/ { try_files $uri $uri/ /myapp/index.php?$query_string; } - 框架内硬编码的 URL（如
href="/user"）应改为相对路径或使用辅助函数：url('user')（Laravel）、url('user/index')（ThinkPHP）
最易被忽略的是：Web 服务器配置和框架路由前缀必须严格一致，差一个斜杠或大小写都可能让重写失败——别只盯着 PHP 代码，先确认请求到底有没有进到 index.php。
