最简洁可靠的方式是匹配 OPTIONS 请求后直接返回 204 No Content 并设置 Access-Control-Allow-Origin、Methods、Headers、Credentials 和 Max-Age 等必要响应头，不转发给后端。
在 Nginx 中处理浏览器发起的 CORS 预检（OPTIONS）请求，最简洁可靠的方式就是匹配到 OPTIONS 方法后直接返回 204 No Content，不转发给后端，同时带上必要的跨域响应头。
匹配 OPTIONS 请求并立即返回 204
只需在 server 或 location 块中添加一条明确的 if 判断或 location 匹配，拦截所有 OPTIONS 请求并终止处理流程：
- 用
if ($request_method = 'OPTIONS') { ... }是常见写法，但注意if在 location 外部有局限，推荐放在 location 内部使用 - 更稳妥的做法是单独定义一个
location = /或通配location ^~ /下的limit_except，但实际最常用、最直观的是下面这种写法
必须设置的关键响应头
仅 return 204 不够，浏览器会校验响应头是否满足预检要求。至少要包含：
-
Access-Control-Allow-Origin：指定允许的源，如*或具体域名（如https://example.com） -
Access-Control-Allow-Methods：列出允许的实际请求方法，如GET, POST, PUT, DELETE, PATCH -
Access-Control-Allow-Headers：声明允许的自定义请求头，如Content-Type, Authorization, X-Requested-With -
Access-Control-Allow-Credentials：如需带 cookie，需设为true，此时Access-Control-Allow-Origin不能为* -
Access-Control-Max-Age：可选，缓存预检结果的时间（单位秒），减少重复 OPTIONS 请求
Nginx 配置示例（推荐放 location 块内）
假设你的 API 接口在 /api/ 路径下，可以这样配置：
Comet AI 浏览器
下载
下载 Comet AI 浏览器，体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作，让 AI 成为你的浏览副驾，大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。
location /api/ {
# 处理预检请求
if ($request_method = 'OPTIONS') {
add_header Access-Control-Allow-Origin "https://your-frontend.com";
add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, PATCH, OPTIONS";
add_header Access-Control-Allow-Headers "Content-Type, Authorization, X-Requested-With";
add_header Access-Control-Allow-Credentials "true";
add_header Access-Control-Max-Age 86400;
add_header Access-Control-Expose-Headers "X-Total-Count";
return 204;
}
<pre class="brush:php;toolbar:false;"># 正常请求代理到后端
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;}
注意：add_header 在 if 块中生效，且 return 204 会立即结束请求，后续 proxy 指令不会执行。
避免常见坑点
有几个细节容易导致预检失败：
- 不要在
if外部（比如 server 级）写add_header，它不会继承到if分支里；每个add_header必须显式写在if块内 -
return 204后不能跟其他指令（比如 proxy_pass），Nginx 会报错 - 如果前端发的是带 credentials 的请求（如 withCredentials: true），
Access-Control-Allow-Origin必须是具体域名，不能用* - 确保 Nginx 版本 ≥ 1.7.5（支持
if+add_header组合），低版本建议升级或改用map+add_header全局方式
