现象: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,再在网关或框架任选一层正确响应,两处同时拦就会互相覆盖,排查时要一起看。
