Nginx可通过rewrite指令结合$arg_xxx变量将查询参数重写为规范路径，需加permanent或redirect实现外部跳转，并配合map、if等提升安全性与灵活性。
Nginx 本身不执行“动态参数到路径”的运行时计算，但可通过 rewrite 指令结合内置变量（如 $arg_xxx）将查询参数提取出来，重写为语义清晰、利于缓存和 SEO 的规范路径。关键在于：重写发生在请求处理早期，且需配合 permanent 或 redirect 标志对外暴露标准形式。
用 rewrite 提取参数并重定向为静态路径
当请求带参数（如 /product?id=123&type=book），想转成 /product/123/book 这类结构，可这样写：
- 使用正则捕获参数值，并在重写目标中引用
$1、$2 - 必须加
permanent（301）或redirect（302），否则只是内部重写，客户端 URL 不变 - 确保原始请求能被 location 匹配到，例如用
location = /product { ... }或更宽泛的匹配
示例配置：
location = /product {rewrite ^/product$ /product/$arg_id/$arg_type? permanent;
}
访问 /product?id=123&type=book 就会 301 跳转到 /product/123/book（注意末尾 ? 用于丢弃原始 query string）。
按参数值做条件路径归一化
某些参数只影响路径前缀或版本，可用 map 预定义映射关系，再配合 rewrite 统一处理，比 if 更安全高效：
- 先用
map把$arg_version映射为路径段，如"v2" → "/api/v2" - 再在 location 中用
rewrite拼接，避免重复判断 - 适合多参数组合、需保持路径层级一致的场景
示例：
map $arg_version $api_ver {default "/api/v1";
"v2" "/api/v2";
"v3" "/api/v3";
}
location /old-api/ {
rewrite ^/old-api/(.*)$ $api_ver/$1 permanent;
}
处理多参数嵌套路径的重写技巧
若参数对应多级路径（如 ?category=tech&tag=nginx&page=2 → /tech/nginx/page/2），单条 rewrite 难以覆盖所有组合。推荐分层处理：
- 用
if判断必要参数是否存在，缺失则返回 400 或跳默认页 - 用
rewrite按固定顺序拼接，例如rewrite ^/search$ /$arg_category/$arg_tag/page/$arg_page? permanent; - 对可选参数（如
page）单独处理：先尝试带 page 的重写，不匹配再 fallback 到无 page 版本
注意：含空格或特殊字符的参数值需确保已正确 URL 编码，Nginx 默认不自动解码参数名/值；若后端依赖原始编码，重写时不要丢弃 query string。
验证与避坑要点
rewrite 生效与否不能只看配置语法，必须实测：
- 用
curl -I查看响应头中的Location，确认跳转目标是否符合预期 - 检查 access_log 中的
$request_uri和$uri，区分原始请求与归一化后路径 - 避免
rewrite+proxy_pass循环：若重写后仍命中同一 location，可能触发多次重写，加break或调整 location 范围 - 不要在
if块里直接写proxy_pass——Nginx 不允许，应改用map定义 upstream 变量
