Apache .htaccess重写规则丢失查询参数问题排查与解决

嘿，我来帮你捋清楚这个问题哈！

一、为啥原查询参数会丢？ #

先给你拆解两个核心点，搞懂这俩就明白问题出在哪了：

• RewriteRule只匹配路径：你写的RewriteRule ^(.*)$里的正则，只会匹配URL里的路径部分（比如/aaa），完全碰不到后面的?param=xxx这串查询字符串。
• QSA的真实作用：[QSA]是Query String Append的缩写，它的功能就是把原请求里的查询字符串（也就是param=xxx），追加到你在规则里指定的新查询字符串后面。

那你现在遇到参数丢失，大概率是这两个情况之一：

1. 规则里的参数名写错了！你想要把路径放到q参数里，但实际写的是a=$1，结果你在PHP里取$_GET['q']自然只能拿到aaa，原参数其实在$_GET['a']旁边待着呢，只是你没找对地方；
2. 服务器配置的问题：比如你的.htaccess文件没生效（需要开启AllowOverride All），或者有其他重写规则先把请求拦截了，导致QSA没发挥作用。

二、修改规则，完美保留参数 #

按照你的需求——把example.com/aaa?param=xxx转成example.com/index.php?q=aaa&param=xxx，正确的规则应该是这样的：

RewriteEngine On
# 排除真实存在的文件和目录，避免把静态资源也重写到index.php
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?q=$1 [QSA,L]

加那两行RewriteCond是为了优化：如果用户访问的是真实存在的文件（比如/style.css）或者目录（比如/uploads/），就不执行重写，只有访问不存在的路径时才触发规则，这是伪静态规则的通用操作。

三、快速验证规则是否生效 #

你可以在index.php里加一段简单的代码，打印所有GET参数，一眼就能看出是否成功保留了原参数：

<?php
var_dump($_GET);
?>

访问example.com/aaa?param=xxx之后，如果输出是array(2) { ["q"]=> string(3) "aaa" ["param"]=> string(3) "xxx" }，就说明规则完全生效啦！

内容的提问来源于stack exchange，提问作者rudyanshah8342