如何将非指定前缀的URL重定向至目标前缀（proxy_pass场景）

你提到的正则取反方案确实能实现需求，但其实利用Nginx原生的location匹配优先级，我们能写出更高效、可读性更强的配置——毕竟正则匹配的性能开销比前缀匹配要高，尤其是在高并发场景下，这种差异会被放大。

先说说你考虑的正则取反方案（可行但非最优） #

先给你贴个可运行的正则取反配置，方便你对照：

server {
    # 基础配置（监听端口、域名等）
    listen 80;
    server_name your-domain.com;

    # 正则取反：匹配所有不以/abcd/开头的URL
    location ~ ^/(?!abcd/) {
        # 永久重定向到带/abcd/前缀的URL，保留原请求路径和参数
        return 301 /abcd/$request_uri;
    }

    # 处理/abcd/前缀的请求，转发到后端服务
    location /abcd/ {
        proxy_pass http://your-backend-service;
        # 必备的proxy配置（按需调整）
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

这个方案的问题在于：正则匹配的逻辑相对复杂，后期维护时可能需要花时间理解取反语法；而且正则匹配的效率不如Nginx原生的前缀匹配，请求量越大，性能差距越明显。

更优方案：利用location匹配优先级实现 #

Nginx的location匹配是有明确优先级的：^~前缀匹配 > 正则匹配 > 普通前缀匹配。我们可以利用这个特性，先优先匹配/abcd/前缀的请求，剩下的所有请求统一重定向，配置逻辑非常直观：

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

    # 优先匹配/abcd/前缀的请求，直接转发到后端
    # ^~ 标记表示这是一个优先匹配的前缀规则，会跳过后续的正则匹配
    location ^~ /abcd/ {
        # 如果后端不需要接收/abcd/前缀，可以用rewrite去掉
        rewrite ^/abcd/(.*)$ /$1 break;
        proxy_pass http://your-backend-service;
        
        # 必备proxy配置
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    # 匹配所有其他请求，统一重定向到带/abcd/前缀的URL
    location / {
        # $request_uri 包含了完整的请求路径和查询参数，直接拼接即可保留原请求信息
        return 301 /abcd$request_uri;
    }
}

这个方案的核心优势： #

• 性能更高：前缀匹配是Nginx原生的高效匹配逻辑，比正则匹配快得多，适合高并发场景。
• 可读性强：配置逻辑一目了然，新人接手也能快速理解，后期维护成本低。
• 兼容性好：不会因为正则的特殊字符处理问题导致意外的匹配错误。

几个关键细节提醒 #

1. 重定向类型选择：测试阶段建议用302临时重定向，确认配置无误后再换成301永久重定向——避免浏览器缓存错误的重定向规则，导致后续调试麻烦。
2. 后端路径处理：如果你的后端服务不需要/abcd/前缀，一定要加上rewrite ^/abcd/(.*)$ /$1 break;，否则后端会收到带/abcd/的请求路径，可能导致404。
3. 参数保留：$request_uri已经包含了查询参数（比如?id=123），所以不需要额外拼接?$args，直接用/abcd$request_uri就能完整保留原请求的所有信息。

内容的提问来源于stack exchange，提问作者Peter Jurkovič