nginx二进制安装默认不处理options请求，需显式配置返回204或200并设置cors头；推荐用if判断+$request_method配合add_header与return 204，或limit_except放行，避免透传至上游导致405/502。
Nginx 二进制安装默认不显式拦截或拒绝 OPTIONS 请求，但很多场景下（如跨域预检、API 调用）需要明确支持它——尤其是当后端服务未处理预检请求时，Nginx 需主动响应 204 No Content 或带正确头的 200 OK。配置关键在于 显式定义 OPTIONS 方法的 location 处理逻辑，而非依赖默认行为。
明确允许并响应 OPTIONS 请求
Nginx 不会自动为 OPTIONS 方法返回成功响应，除非你明确配置。若未配置，它可能直接透传给上游（失败），或因无匹配 location / 无 limit_except 放行而返回 405 Method Not Allowed。
建议在对应 server 或 location 块中添加：
location / {
# 允许常见方法，包含 OPTIONS
limit_except GET HEAD POST PUT DELETE OPTIONS {
deny all;
}
# 或更简洁：直接对 OPTIONS 返回 204（推荐用于预检）
if ($request_method = 'OPTIONS') {
add_header Access-Control-Allow-Origin "*";
add_header Access-Control-Allow-Methods "GET, POST, OPTIONS, PUT, DELETE";
add_header Access-Control-Allow-Headers "DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization";
add_header Access-Control-Max-Age 86400;
add_header Access-Control-Allow-Credentials true;
add_header Content-Length 0;
add_header Content-Type text/plain;
return 204;
}
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
⚠️ 注意：if 在 location 中虽可用，但属于 Nginx 的“有限上下文”，仅用于简单判断；生产环境更推荐用 limit_except + add_header 组合，或配合 try_files/return 实现无代理响应。
配置跨域相关头部（常与 OPTIONS 同时需要）
即使只做 OPTIONS 响应，也需同步设置 CORS 头，否则浏览器仍会拒绝后续实际请求。关键头包括：
-
Access-Control-Allow-Origin（必需，不可为*+Access-Control-Allow-Credentials: true共存） Access-Control-Allow-MethodsAccess-Control-Allow-HeadersAccess-Control-Max-Age-
Access-Control-Allow-Credentials（按需）
这些头必须出现在 OPTIONS 响应中，也建议加在正常请求响应里（可统一用 add_header 在 server 或 location 级）：
location /api/ {
add_header Access-Control-Allow-Origin "https://your-app.com";
add_header Access-Control-Allow-Credentials "true";
add_header Access-Control-Allow-Methods "GET, POST, OPTIONS, PUT, DELETE";
add_header Access-Control-Allow-Headers "Content-Type, Authorization, X-Requested-With";
if ($request_method = 'OPTIONS') {
add_header Access-Control-Max-Age 1728000;
add_header Content-Length 0;
add_header Content-Type text/plain;
return 204;
}
proxy_pass http://api_backend;
}
避免常见陷阱
- 不要只写
add_header而不return 204：OPTIONS请求若继续往下走（比如到proxy_pass），而上游不处理，就会返回502或405。 -
add_header在if块中有效，但proxy_*指令无效——if内不能用proxy_pass。 - 若使用
limit_except，需确保OPTIONS在允许列表中，否则会被deny all拦截。 - Windows 下二进制版 Nginx 无模块缺失问题，
limit_except和if均原生支持，无需额外编译。
不复杂但容易忽略。
