跨域预检 OPTIONS 返回 403 反向代理怎么放行才不拦

前后端分离的项目,前端跑在 loCalhost:5173,接口域名是 api.example.com。带 Authorization 头的 POST 一发出,控制台就是一句 Response to preflight request does not have HTTP ok status,Network 里那条 OPTIONS 是 403。

点开响应,返回的是 nginx 的 403 页面,不是应用里的 JSON,说明请求压根没进到后端。后端其实配了 CORS 过滤器,但它只处理 GET 和 POST,OPTIONS 在更前面就被挡了。

翻站点的 conf,找到一段早年防扫描留下的规则:if ($request_method !~ ^(GET|POST)$) { return 403; }。它写在 server 层,location 里的配置还没轮到执行就返回了。这类规则接手老项目时特别容易踩,肉眼扫一遍配置经常漏掉。

改法是在 location 里先判断 OPTIONS,直接 return 204,同时补上 Allow-Origin、Allow-Methods、Allow-Headers 和 Max-Age。顺序很重要,if 要放在 proxy_pass 前面,否则 204 出不去。Allow-Origin 用 $http_origin 回显,不能用星号,因为请求带了凭证。

还有一个连带问题:proxy_pass 末尾多写了一个斜杠,路径被改写,预检 204 了但正式 POST 变成 404,查了半小时才发现。去掉斜杠后一切正常。

验证用 curl 发 OPTIONS,带上 Origin 和 Access-Control-Request-Method,看返回 204 和三个头齐全;再刷新页面,POST 返回 201,控制台干净。

location /api/ {
  if ($request_method = OPTIONS) {
    add_header Access-Control-Allow-Origin $http_origin;
    add_header Access-Control-Allow-Methods
      "GET,POST,PUT,DELETE,OPTIONS";
    add_header Access-Control-Allow-Headers
      "Authorization,Content-Type";
    add_header Access-Control-Max-Age 86400;
    return 204;
  }
  proxy_pass http://127.0.0.1:8080;
}

您可以还会对下面的文章感兴趣: