动态归一化指在反向代理中依据请求特征实时调整路径结构以统一适配后端路由，推荐用map指令实现安全条件映射，结合rewrite与proxy_pass斜杠规则精准剥离或注入路径，并通过header保留原始上下文。
动态归一化是指在反向代理过程中，根据请求特征（如域名、参数、头信息等）实时调整路径结构，使不同来源的请求统一适配后端服务的预期路由格式。这比静态重写更灵活，也更贴近真实业务场景。
用 map 指令实现安全的条件路径映射
推荐优先使用 map 而非 if，因为 map 在 server 级预编译，无运行时开销且避免 if 的变量作用域陷阱。
- 按 Host 归一化 API 前缀：前端调用 /v1/user，移动端调用 /mobile/v1/user，都转为 /api/v1/user 发往后端
- 按查询参数版本归一化：/user?version=v2 → /api/v2/user；/user?version=v1 → /api/v1/user
- 示例配置：
map $host $api_prefix {
default "/api";
~^m\. example\.com "/api/mobile";
~^admin\.example\.com "/api/admin";
}
map $arg_version $version_path {
"v1" "/v1";
"v2" "/v2";
default "/v1";
}
location / {
rewrite ^/(.*)$ $api_prefix$version_path/ break;
proxy_pass http://backend/;
}
结合 rewrite 和 proxy_pass 斜杠规则精准剥离/注入路径
归一化成败关键在于路径是否被正确“剥掉”或“补上”。重点看 proxy_pass 末尾斜杠和 rewrite 的 break 标志配合效果。
- 若后端只认 /user/info，但请求是 /app/v2/user/info → 用 rewrite 剥掉 /app/v2，再用 proxy_pass http://backend/ 发送 /user/info
- 若后端要求所有请求带 /internal 前缀 → rewrite ^(.*)$ /internal$1 break，proxy_pass http://backend 不加斜杠，确保发过去是 /internal/user
- 错误示范：proxy_pass http://backend/ + rewrite 不带 break → 可能触发 location 重匹配，造成循环
对多级路径做捕获与重组
复杂路径如 /tenant/{id}/service/{name}/action 需提取关键段并重排，适合用正则捕获组 + $1/$2 引用。
- 将 /t/123/s/users/list → /api/v1/tenants/123/users
- 配置示例：
location ~ ^/t/(\d+)/s/([^/]+)/(.*)$ {
rewrite ^/t/\d+/s/([^/]+)/(.*)$ /api/v1/tenants/$1/$2/$3 break;
proxy_pass http://backend/;
} - 注意：正则匹配需用 ~ 或 ~*，避免 location 字符串匹配干扰捕获逻辑
归一化同时保留原始上下文供后端识别
路径改了，但业务仍需知道原始入口。可通过 header 注入原始路径或标识。
- 添加 X-Original-Path 头：proxy_set_header X-Original-Path $request_uri;
- 注入来源标记：proxy_set_header X-Source-Type $host;
- 若归一化基于 User-Agent，则可设 X-Client-Type: mobile/desktop
