前后端分离后 POST 请求报 403,OPTIONS 预检怎么放行

现象:GET 正常,POST 一律失败

前后端分开部署后,浏览器里 GET 请求能拿到数据,一旦提交 JSON 就报跨域错误。Network 面板里能看到一条 OPTIONS 请求返回 403,后面真正的 POST 根本没发出去。用 Postman 直接调接口却是 200。

原因:预检请求被当成非法方法拦了

当请求带自定义头、使用 Content-Type: application/json 或跨域携带凭证时,浏览器会先发一条 OPTIONS 预检,询问服务器是否允许。这条请求不带业务参数,很多服务端没见过就按非法处理:

  • Nginx 或网关只放行了 GET、POST,OPTIONS 直接返回 403 或 405;
  • WAF 把 OPTIONS 判为探测行为拦截;
  • 预检响应缺少 Access-Control-Allow-Headers,浏览器判定失败;
  • 同时用了 Allow-Origin: * 和 Allow-Credentials: true,浏览器直接拒绝。

解决步骤

第一步,先看预检返回了什么,确认是状态码问题还是响应头缺失。

curl -i -X OPTIONS https://api.你的域名/user \
  -H "Origin: https://www.你的域名" \
  -H "Access-Control-Request-Method: POST"

第二步,在 Nginx 统一处理预检,返回 204 并补齐三个头:

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 "Content-Type,Authorization";
    add_header Access-Control-Max-Age 86400;
    return 204;
}

第三步,需要带 Cookie 时不能用星号,必须回显具体来源,再加 Access-Control-Allow-Credentials: true,否则浏览器会拦下响应。

第四步,同步后端框架配置。Spring 用 @CrossOrigin 或全局 CorsFilter,Django 用 django-cors-headers 并允许 OPTIONS,避免 Nginx 放行了但框架又拒一次。Max-Age 设大一点能减少预检次数,减少一次往返就能少几十毫秒。

第五步,确认错误不是 401 冒充的。有些网关先做鉴权再处理 CORS,OPTIONS 不带 Token 就会被判未登录,日志里显示 401 但浏览器只报跨域。这种情况要把预检请求放在鉴权之前拦截返回。

小结

预检是浏览器行为,不是接口写错了。先用 curl 复现 OPTIONS,再在网关或框架任选一层正确响应,两处同时拦就会互相覆盖,排查时要一起看。

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