QSA标志作用是将原始查询字符串自动追加到重写后的URL末尾而非覆盖；默认RewriteRule会丢弃?后参数，启用QSA后如/register?ref=1→home.php?SK=2&ref=1，实现安全、无冲突的参数合并。
QSA（Query String Append）标志的作用，是让 RewriteRule 在重写 URL 时，自动把原始请求中的查询参数（即 ? 后面的部分）原样追加到目标 URL 的查询字符串末尾，而不是覆盖或丢弃它。这实现了参数的“原子化自动合并”——无需手动拼接、不依赖 RewriteCond 判断、不担心顺序冲突，只要规则匹配，参数就自然叠加。
QSA 解决的核心问题：默认会丢弃原始 query string
Apache 的 RewriteRule 默认只处理 URI path 部分（如 /register），而完全忽略原始请求里的 ?reference=1 这类查询参数。如果不加 QSA，下面这条规则：
- RewriteRule ^register$ home.php?SK=2 [NC,L]
访问 /register?reference=1 时，实际执行的是 home.php?SK=2，reference=1 彻底丢失。
加上 QSA 就自动合并，无需额外逻辑
只需添加 [QSA] 标志：
- RewriteRule ^register$ home.php?SK=2 [QSA,NC,L]
此时访问 /register?reference=1，内部重写目标变为：
home.php?SK=2&reference=1
如果原始请求是 /register?ref=abc&utm_source=mail，结果就是：
home.php?SK=2&ref=abc&utm_source=mail
所有原始参数被完整保留并追加，与新参数共存，没有覆盖、没有冲突、不需正则捕获。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
QSA 和手动拼接的区别：安全、简洁、可维护
有人会尝试用 $1 捕获 query string，再手动拼接，例如：
- RewriteCond %{QUERY_STRING} (.*)
- RewriteRule ^register$ home.php?SK=2&%1 [NC,L]
这种写法有明显缺陷：
- 当原始 query string 为空时（如 /register），%1 变成空值，URL 末尾多出一个 &
- 若原始参数含特殊字符（如空格、&），未转义可能破坏 URL 结构
- 规则变长、易出错、难调试
QSA 内部自动处理空值判断、编码兼容和分隔符插入，更可靠。
配合 RewriteBase 使用时要注意路径上下文
QSA 生效的前提是规则本身能正确匹配。常见陷阱：
- 在子目录项目中（如 /project/），.htaccess 里的规则匹配的是相对路径，不要写
^/register$（开头的 / 会导致永远不匹配） - 务必设置
RewriteBase /project/，否则重写后的资源路径可能错位 - QSA 不影响 RewriteBase，它只管 query string 的合并行为
一个完整可用的示例（位于 /project/.htaccess）：
- RewriteEngine On
- RewriteBase /project/
- RewriteRule ^register$ home.php?SK=2 [QSA,NC,L]
