快速定位Apache重写错误：重命名.htaccess后404消失即确认问题；查error.log中rewrite相关报错；最小测试法验证mod_rewrite是否启用及AllowOverride配置。
Apache 重写规则写错导致全站 404 怎么快速定位
不是 PHP 本身出错，而是 .htaccess 中的 RewriteRule 或 RewriteCond 配置错误，让 Apache 无法正确匹配请求路径，最终返回 404。最常见的情况是：启用 RewriteEngine On 后，规则却没匹配到任何请求，又没提供默认 fallback，所有 URL 就全挂了。
快速判断方法：
- 临时重命名 .htaccess 为 .htaccess.bak，刷新页面——如果 404 消失，基本锁定问题在此文件
- 查看 Apache 错误日志（通常是 /var/log/apache2/error.log 或 /usr/local/apache/logs/error_log），搜索 rewrite 或 per-directory 关键词，常会提示 invalid command、bad flag delimiters 或 no matching section
常见 .htaccess 语法错误及修复写法
以下错误在 Laravel、WordPress、自定义路由项目中高频出现：
-
RewriteRule缺少末尾标志，比如写成RewriteRule ^(.*)$ index.php [L]—— 正确应为RewriteRule ^(.*)$ index.php?path=$1 [L,QSA]，否则$_SERVER['REQUEST_URI']丢失，PHP 路由收不到原始路径 - 混用
^/开头：Apache 在目录级.htaccess中不识别开头的斜杠，^/index\.php$应改为^index\.php$ -
RewriteBase设置错误：若站点部署在子目录（如https://example.com/myapp/），必须加RewriteBase /myapp/，否则重写目标路径会错位 - 漏掉
QSA标志：转发带查询参数的 URL（如/user?id=123）时，不加[QSA]会导致参数被丢弃
PHP 环境下验证 Rewrite 是否生效的最小测试法
别急着改业务规则，先用最简配置确认 Apache 重写模块可用：
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^test$ test.php [L]然后新建一个 test.php，内容为 。访问 /test，能输出即说明重写引擎正常；若仍 404，检查：
- Apache 是否加载了 mod_rewrite（执行 a2enmod rewrite && systemctl restart apache2）
- 虚拟主机配置中是否允许 .htaccess 覆盖（AllowOverride All 必须设在对应
- 文件权限是否让 Apache 可读（chmod 644 .htaccess）
为什么有些 404 不报错但页面空白
这不是 Apache 返回的 404，而是 PHP 脚本被成功调用，但逻辑里没匹配到路由，直接 exit 或返回空内容。典型表现：
- HTTP 状态码是 200，但浏览器显示空白或“Not Found”文字
- error_log 里没有 rewrite 相关报错，但有 PHP warning 如 Undefined index: path
- var_dump($_SERVER) 显示 REQUEST_URI 是原始路径，但 SCRIPT_NAME 或 PATH_INFO 异常
此时要检查：
- .htaccess 是否把请求转给了正确的入口（如 index.php 而非 router.php）
- PHP 脚本是否依赖 $_SERVER['REDIRECT_URL']（Apache 重写后设置的变量），而该变量在某些 FastCGI 模式下不可见，应改用 $_SERVER['REQUEST_URI']
- 是否启用了 OPcache 导致旧规则缓存未刷新（opcache_reset() 或重启 PHP-FPM）
最麻烦的点往往不在语法，而在重写后 PHP 收不到原始路径——这需要同时核对 .htaccess 规则、RewriteBase、PHP 路由解析逻辑三者是否对齐。
立即学习“PHP免费学习笔记（深入）”；
