Nginx应直接拦截OPTIONS请求并返回204，不转发后端；需用if判断请求方法、显式添加带always的CORS头、动态设置Origin、启用缓存，并隔离预检与主请求处理逻辑。
后端应用没处理 OPTIONS 请求导致返回 404，本质是浏览器跨域预检失败，Nginx 没兜底，请求直接透传给了后端——而多数后端框架（如 Spring Boot、Express、Flask）默认不响应 OPTIONS，或只对特定路径响应。解决的关键不是让后端“补全所有 OPTIONS”，而是由 Nginx 在代理层统一拦截并快速响应。
让 Nginx 直接响应 OPTIONS，不转发给后端
这是最稳妥、最轻量的解法。Nginx 自己处理预检，返回 204（无内容）或 200，并带上完整 CORS 头，避免后端参与。
- 在对应 location 块中添加以下配置：
if ($request_method = 'OPTIONS') {
add_header Access-Control-Allow-Origin "https://your-frontend.com";
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,Authorization";
add_header Access-Control-Allow-Credentials "true";
add_header Access-Control-Max-Age 1728000;
add_header Content-Type 'text/plain; charset=utf-8';
return 204;
}
-
注意：不要用
proxy_pass转发 OPTIONS；也不要用rewrite或return 200后再加头——return会终止流程，必须配合add_header才生效 - Origin 值建议按实际前端域名写死，或用变量动态控制（如
$http_origin+ 白名单校验），避免通配符*与Access-Control-Allow-Credentials: true冲突
检查后端是否真需要处理 OPTIONS
有些场景下后端确实要介入（比如带鉴权的 OPTIONS 需校验 token），但多数情况不需要。先验证：
- 用 curl 模拟浏览器预检：
curl -X OPTIONS -H "Origin: https://your-frontend.com" -H "Access-Control-Request-Method: POST" -I https://your-api.com/path - 如果返回 404 或 405，说明后端未注册该路径的 OPTIONS handler；如果返回 200/204 但缺 CORS 头，问题在后端响应头漏配，而非 Nginx
- 若后端必须处理，Spring Boot 可加
@CrossOrigin或全局配置；Express 可用app.options("*", ...)；但不如 Nginx 层统一处理高效稳定
避免 location 匹配遗漏导致 OPTIONS 被错误路由
如果 Nginx 配置了多个 location，且没有显式覆盖 OPTIONS，它可能落入默认匹配规则（比如静态文件 location），最终返回 404。
- 确保 OPTIONS 请求能命中你期望的代理 location —— 可加日志确认：
log_format options '$request_method $uri $status'; access_log /var/log/nginx/options.log options; - 不要依赖
location /的模糊匹配，对 API 接口建议用明确前缀，例如：location ^~ /api/ { ... }，并在其中统一处理 OPTIONS - 若使用正则 location（如
location ~ \.php$），需注意优先级：前缀字符串匹配 > 正则匹配，OPTIONS 不匹配正则时可能掉到 root 下返回 404
确认 proxy_intercept_errors 是否干扰
这个指令会影响错误状态码的透传行为，但它对 OPTIONS 本身无直接作用；不过若你在 location 中启用了它，又配置了 error_page 404，可能意外覆盖 OPTIONS 的 204 返回。
- 除非你明确想用自定义页面接管 404，否则对 API 代理建议关闭：
proxy_intercept_errors off; - 若开启，务必确保
error_page 404不作用于 OPTIONS 方法——可加条件判断：if ($request_method != 'OPTIONS') { proxy_intercept_errors on; }（但 Nginx 不支持 if 嵌套，需拆到不同 location）
