无需if指令的基于HTTP头的Nginx proxy_pass转发方案咨询

Got it, let's ditch those finicky if directives—Nginx's official docs aren't kidding when they call if "evil" inside locations, it can lead to unexpected behavior and performance quirks. Instead, we'll use the map module, which is the recommended approach for conditional routing like this. It's cleaner, more efficient, and aligns with Nginx's design philosophy.

核心思路 #

We'll define variable mappings at the http level (outside your server/location blocks) to determine the target server based on your rules, in order of priority:

1. Highest priority: If the Server-A header is set to true, route to server-a
2. Next: If Account-ID is a 10-digit number ending in 00-05, route to server-a
3. Default: All other traffic goes to server-b

完整配置示例 #

http {
    # First map: Check for the Server-A header (highest priority)
    map $http_server_a $target_server {
        # Match when Server-A header equals "true"
        true    http://server-a.company.com;
        # For all other cases, leave this variable empty for now
        default "";
    }

    # Second map: Handle Account-ID rule only if Server-A didn't match
    map $http_account_id $fallback_target {
        # Match 10-digit Account-ID ending in 00-05 (^\d{8} ensures first 8 are digits, 0[0-5] covers last two)
        ~^\d{8}0[0-5]$    http://server-a.company.com;
        # Default to server-b if Account-ID doesn't match
        default           http://server-b.company.com;
    }

    # Combine the two maps: Use target_server if it's set, else use fallback_target
    map $target_server $final_target {
        ""    $fallback_target;
        default $target_server;
    }

    server {
        listen 80;
        server_name your-domain.com;

        location /rest/accounts/ {
            # Use our precomputed final_target variable for proxying
            proxy_pass $final_target;

            # Don't forget these essential proxy headers (adjust as needed)
            proxy_set_header Host $host;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
}

为什么这比if更好？ #

• No unexpected behavior: map evaluates variables once at the start of the request, avoiding the weird edge cases that come with if inside locations (like unintended header overrides or skipped directives).
• Better performance: Map lookups are optimized in Nginx, making this approach more efficient than chaining if statements.
• Easier to maintain: The rules are clearly separated and ordered by priority, so you can tweak them later without breaking everything.

小细节调整 #

• If you want to route to server-a anytime the Server-A header exists (not just when it's true), change the first map's condition to ~.* instead of true.
• Double-check the regex for Account-ID: ^\d{8}0[0-5]$ strictly matches 10-digit numbers ending in 00-05. If you meant 00-04 (to hit exactly 5% of traffic), adjust it to 0[0-4].

内容的提问来源于stack exchange，提问作者user3105453