如何在 Apache 重写规则中保留原始 GET 参数（QSA 标志详解）

Apache作为主流的Web服务器，其mod_rewrite模块提供的URL重写功能被广泛应用于路由美化、旧链接跳转等场景。很多开发者在配置重写规则时会遇到原始GET参数丢失的问题，这时候QSA标志就能派上用场。

QSA标志是什么

QSA是Query String Append的缩写，是Apache mod_rewrite模块中RewriteRule指令的可选标志之一。当我们在重写规则中加上[QSA]标志时，Apache会把原始请求的查询字符串（也就是URL中?后面的部分）附加到重写后的目标URL的查询字符串后面。

如果没有使用QSA标志，当重写规则的目标URL中包含自己的查询字符串时，原始请求的查询字符串会被直接丢弃，只保留目标URL中的查询字符串。

基础使用示例

假设我们有一个原始请求：http://ippipp.com/article.php?id=123&page=2，现在需要把所有访问/article/路径的请求重写到article.php，同时保留原始的参数。

不使用QSA的重写规则配置如下：

# 没有QSA的情况
RewriteEngine On
RewriteRule ^article/([0-9]+)$ article.php?id=$1 [L]

这时候如果请求http://ippipp.com/article/123?page=2，重写后的目标URL是article.php?id=123，原始的page=2参数会被丢弃。

加上QSA标志后的规则：

# 使用QSA的情况
RewriteEngine On
RewriteRule ^article/([0-9]+)$ article.php?id=$1 [QSA,L]

同样请求http://ippipp.com/article/123?page=2，重写后的目标URL会变成article.php?id=123&page=2，原始参数被成功保留。

QSA的特殊场景说明

目标URL本身带查询字符串的情况

如果重写规则的目标URL已经包含了查询字符串，QSA会把原始查询字符串追加到后面，用&连接。比如规则如下：

RewriteEngine On
RewriteRule ^test/(.*)$ test.php?type=$1 [QSA,L]

请求http://ippipp.com/test/news?sort=time时，重写后的URL是test.php?type=news&sort=time，两个参数都会保留。

原始请求没有查询字符串的情况

如果原始请求没有查询字符串，QSA标志不会添加任何额外内容，重写规则和普通规则效果一致，不会产生多余的?或者空参数。

常见误区

• 误区1：认为QSA会自动合并重复的参数。实际上QSA只是简单拼接，如果原始参数和目标URL参数有同名key，会出现两个相同的参数，比如原始参数有id=1，目标URL也有id=2，拼接后是id=2&id=1，具体读取哪个取决于服务端的处理逻辑。
• 误区2：所有重写规则都需要加QSA。只有当需要保留原始请求的查询字符串时才需要加，如果重写后的目标URL已经包含了所有需要的参数，或者不需要原始参数，就不需要使用QSA。
• 误区3：QSA和QSADisabled冲突。QSADisabled是另一个标志，作用是禁用QSA的自动追加，如果同时设置这两个标志，QSADisabled的优先级更高，QSA不会生效。

完整配置示例

下面是一个实际的项目路由重写配置，把所有前端路由请求重写到index.php，同时保留所有GET参数：

# 开启重写引擎
RewriteEngine On

# 如果请求的不是真实存在的文件或目录，才进行重写
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 重写到index.php，保留原始GET参数
RewriteRule ^(.*)$ index.php [QSA,L]

这个配置下，请求http://ippipp.com/user/profile?tab=info会被重写到index.php?tab=info，服务端可以通过$_GET['tab']正常获取到参数。

ApacherewriteQSA_flagGET_parametermod_rewrite修改时间：2026-05-30 23:24:53