Nginx OPTIONS 请求怎么避免在复杂的 URL 重写规则中被误伤导致重定向循环-Nginx-PHP中文网

nginx 中 options 请求陷入重定向循环，主因是被无差别 rewrite 规则匹配并执行 last 跳转，导致新 uri 再次命中同一规则；应优先在 location 中拦截 options 并 return 204，避免其进入 rewrite 流程。

nginx options 请求怎么避免在复杂的 url 重写规则中被误伤导致重定向循环

Nginx 中 OPTIONS 请求被误卷入重定向循环，通常不是因为 OPTIONS 本身触发跳转，而是它被 rewrite 规则无差别匹配、执行了 last 跳转，又因路径未排除或 location 匹配过宽，导致新 URI 再次命中同一规则——尤其在预检请求（CORS）场景下极易暴露问题。

明确 OPTIONS 请求的特殊性
OPTIONS 请求常由浏览器自动发起（如跨域 AJAX 预检），不带 Cookie、无 body，且多数后端不处理具体业务逻辑。若它被 rewrite 规则捕获并重写 + last，就可能进入匹配闭环；而它本身又不携带重定向状态，Nginx 日志里往往只显示 500 或反复 301，排查困难。

用 location 精确拦截并提前终止
不要让 OPTIONS 进入通用 rewrite 流程。在涉及重写的 location 块顶部，优先匹配并直接返回：

location / {
    # 先处理 OPTIONS，不走任何 rewrite
    if ($request_method = 'OPTIONS') {
        add_header Access-Control-Allow-Origin "*";
        add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS";
        add_header Access-Control-Allow-Headers "DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization";
        add_header Access-Control-Max-Age "1728000";
        add_header Access-Control-Allow-Credentials "true";
        add_header Content-Length 0;
        add_header Content-Type "text/plain; charset=utf-8";
        return 204;
    }

    # 后续 rewrite 规则只对非-OPTIONS 请求生效
    rewrite ^/old/(.*)$ /new/$1 break;
    ...
}

⚠️ 注意：if 在 location 内用于 $request_method 是安全的，Nginx 官方明确允许此用法；但避免在 if 中嵌套 rewrite 或 proxy_pass。

避免 rewrite 无条件触发 OPTIONS
常见错误是使用前缀匹配 location（如 location /api/）+ 无 guard 的 rewrite：

# ❌ 危险：OPTIONS /api/users 也会被重写，且 /new/xxx 可能再次落入 /api/ 匹配
location /api/ {
    rewrite ^/api/(.*)$ /v2/$1 last;
}

✅ 正确做法：加条件限定仅对特定方法或路径生效：

location /api/ {
    # 只对 GET/POST 等业务请求重写，跳过 OPTIONS、HEAD
    if ($request_method ~ ^(GET|POST|PUT|DELETE)$) {
        rewrite ^/api/(.*)$ /v2/$1 break;
    }
}

或更推荐——改用正则 location 显式排除：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

# ✅ 精确匹配，且天然排除 OPTIONS（除非显式写出）
location ~ ^/api/(?!(options|OPTIONS)) {
    rewrite ^/api/(.*)$ /v2/$1 break;
}

禁用 rewrite 对 OPTIONS 的影响（关键补丁）
若已有复杂 rewrite 规则难以逐条修改，可在 server 或 http 块中统一“屏蔽”：

# 在 server 块顶部添加
map $request_method $skip_rewrite {
    default     0;
    OPTIONS     1;
}

# 然后所有 rewrite 加条件
rewrite ^/old/(.*)$ /new/$1 break if=$skip_rewrite=0;

这样 rewrite 仅在 $skip_rewrite=0（即非 OPTIONS）时执行，彻底隔离。

检查 proxy_pass 场景下的连锁反应
若 OPTIONS 请求被 proxy_pass 到后端，而后端返回 302（例如某些老旧 PHP 框架对 OPTIONS 返回跳转），Nginx 默认会转发该 Location 头——此时浏览器再发 OPTIONS 到新地址，形成循环。

解决方式：