QSA标志用于将原始查询字符串追加到新URL后实现参数合并；仅当Substitution含“?”时生效，否则原始参数默认透传，常见失效原因包括模块未启用、AllowOverride限制或正则书写错误。
QSA（Query String Append）标志是 Apache mod_rewrite 中处理查询参数的关键机制，它的作用不是“保留”原始参数，而是把原有 query string 自动追加到你新写的 URL 后面，实现参数合并。不加 QSA，新写的 ? 后参数会直接覆盖旧参数；加了 QSA，才能做到 你写你的，用户传的也留着。
QSA 的基本用法和生效前提
QSA 只在 RewriteRule 的 Substitution 部分包含 ? 时才真正起作用。它不会自动保留参数——只有当你显式写出一个 ? 并添加新参数后，QSA 才负责把原始 query string 接在后面，用 & 拼接。
- 原始请求：
https://example.com/search?q=apple - 规则：
RewriteRule ^/s/(.*)$ /search.php?term=$1 [QSA,L] - 结果：
/search.php?term=apple&q=apple（注意：原始 q=apple 被完整保留）
如果 Substitution 不含 ?，比如 /search.php，那么即使加了 QSA，也不会产生新参数，原始 query string 仍会原样透传过去（这是默认行为，QSA 此时无实际影响）。
常见错误：QSA 不生效的几种典型场景
QSA 看似简单，但常因配置环境或书写细节失效：
- mod_rewrite 模块未启用：运行
a2enmod rewrite（Debian/Ubuntu）或确认LoadModule rewrite_module modules/mod_rewrite.so在httpd.conf中已取消注释 - .htaccess 生效被禁：对应目录的虚拟主机配置中必须设
AllowOverride All，不能是None或FileInfo - 规则写在错误上下文：RewriteRule 匹配的是 URI path，不包括 query string；想匹配 ?ref=abc 这类内容，必须用
RewriteCond %{QUERY_STRING}配合判断 - 正则开头多写了 /：在 .htaccess 中，pattern 应写
^s/(.*)$，而不是^/s/(.*)$（开头的 / 会被 Apache 自动剥离）
实用组合：QSA + 条件判断 + 多参数注入
真实项目中往往需要根据 query string 内容动态调整行为。例如：当 URL 带 phone=123 时跳转到特定接口，并统一加上 company=1，同时保留所有原始参数。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
配置示例（放在 VirtualHost 或 .htaccess 中）：
RewriteEngine On
RewriteCond %{QUERY_STRING} ^phone=
RewriteRule ^/$ /default/myaction_phone?company=1 [QSA,R=302,L]
RewriteRule ^/$ /default/myaction?company=1 [QSA,R=302,L]
说明：
- 第一条规则先检查 query string 是否以
phone=开头，满足则跳转到myaction_phone，并注入company=1，QSA 把原始phone=123接在后面 → 最终 URL 是/default/myaction_phone?company=1&phone=123 - 第二条是兜底规则，不带 phone 时走通用入口，同样注入 company=1，且不丢原始参数（如
?utm_source=ad） - 使用
R=302而非R=301，方便调试，避免浏览器缓存错误跳转
调试建议：快速验证 QSA 是否工作
最直接的方式是构造一个带参数的请求，观察重定向后的地址栏或服务器日志：
- 临时加一条测试规则：
RewriteRule ^/test$ /echo.php?a=1 [QSA,R=302,L] - 访问
/test?b=2&c=3，应看到跳转到/echo.php?a=1&b=2&c=3 - 若只看到
/echo.php?a=1，说明 QSA 未生效，重点检查模块启用状态和 AllowOverride 设置
QSA 不复杂，但容易忽略生效条件和使用边界。只要 pattern 写对、Substitution 显式含 ?、模块与权限到位，参数合并就自然成立。
