Nginx 中负载均衡怎么配置 hash 键值自定义策略实现精准路由-Nginx-PHP中文网

nginx可通过hash指令配合变量实现基于url路径、请求头/cookie、查询参数的自定义哈希路由，需使用map预处理变量并启用consistent参数保障一致性。

nginx 中负载均衡怎么配置 hash 键值自定义策略实现精准路由

Nginx 本身不支持直接对任意请求字段（如 URL 路径、Header、参数）做自定义哈希键值的原生配置，但可通过 hash 指令配合变量实现精准路由，前提是使用 ngx_http_upstream_hash_module（Nginx 1.7.2+ 默认内置，无需额外编译）。

关键点在于：hash 的输入必须是 Nginx 变量（$variable），且该变量需在请求处理早期可稳定获取。下面分三类实用场景说明配置方法和注意事项：

基于请求路径哈希（URL 精准路由）

适合按资源路径做一致性分发，比如 /api/user/123 → 固定到某台后端，提升缓存命中率或避免跨节点状态冲突。

配置示例：

upstream backend_by_path {
    hash $request_uri consistent;  # 使用完整 URI 哈希，加 consistent 减少节点增减时的重映射
    server 192.168.1.10:8080;
    server 192.168.1.11:8080;
    server 192.168.1.12:8080;
}

说明：

$request_uri 包含路径+查询参数（如 /user?id=100），若只需路径部分，改用 $uri（不含 query）
consistent 参数启用一致性哈希，比默认普通哈希更抗节点变动抖动
注意：URI 中含动态参数（如时间戳、随机数）会导致哈希失效，建议前置用 map 清洗

基于请求头或 Cookie 自定义键

当需要按用户 ID、设备标识等业务字段路由时，可提取 Header 或 Cookie 中的值构造哈希键。

在SEO发布前，从路由清单生成XML网站地图和robots.txt

当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。

下载

例如从 X-User-ID 头取值：

map $http_x_user_id $hash_key {
    ""      "anonymous";
    default $http_x_user_id;
}
<p>upstream backend_by_user {
hash $hash_key consistent;
server 192.168.1.10:8080;
server 192.168.1.11:8080;
}</p>

说明：

map 块用于安全转换：避免空值导致哈希异常，统一 fallback 到 anonymous
$http_x_user_id 是 Nginx 自动将 Header 名转为小写下划线格式的变量
若字段在 Cookie 中（如 uid=abc123），可用 $cookie_uid 直接引用

基于查询参数提取哈希键（如 tenant_id）

多租户系统中常需按 ?tenant_id=org-a 将同租户流量固定到同一组后端。

配置方式：

map $args $tenant_hash {
    ~tenant_id=([^&]+) $1;
    default "default_tenant";
}
<p>upstream backend_by_tenant {
hash $tenant_hash consistent;
server 192.168.1.20:8080;
server 192.168.1.21:8080;
}</p>

说明：