Nginx中OPTIONS预检请求对于后端Node.js服务调用的优化-Nginx-PHP中文网

Nginx 应在网关层直接响应 OPTIONS 预检请求并返回 204，避免穿透至 Node.js；需配置 Access-Control 相关头，关闭 Node.js 的 CORS 预检处理，实现高效协同。

nginx中options预检请求对于后端node.js服务调用的优化

在前后端分离架构中，浏览器发起跨域请求时会先发送一个 OPTIONS 预检请求，用于确认后端是否允许该跨域操作。如果 Node.js 后端未正确处理 OPTIONS 请求，Nginx 可能将它直接转发过去，导致额外的请求开销、延迟甚至 404/500 错误。优化的关键不是“禁用”预检，而是让 Nginx 在网关层高效响应它，避免穿透到 Node.js 应用。

明确哪些请求会触发 OPTIONS 预检

并非所有跨域请求都会触发预检。只有满足以下任一条件时，浏览器才会先发 OPTIONS：

使用了自定义请求头（如 Authorization、X-Request-ID）
请求方法不是 GET、HEAD、POST
POST 的 Content-Type 不是 application/x-www-form-urlencoded、multipart/form-data 或 text/plain

常见场景如带 token 的 JSON 请求（Content-Type: application/json）必然触发预检。确认业务中哪些接口属于此类，有助于聚焦优化范围。

Nginx 层直接响应 OPTIONS 请求

Node.js 通常无需业务逻辑处理 OPTIONS，因此最轻量的做法是在 Nginx 中拦截并返回 204 响应。示例配置如下：

location /api/ {
    if ($request_method = 'OPTIONS') {
        add_header Access-Control-Allow-Origin "*";
        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,Accept,Origin";
        add_header Access-Control-Max-Age 1728000;
        add_header Access-Control-Allow-Credentials true;
        add_header Content-Length 0;
        add_header Content-Type text/plain;
        return 204;
    }

    proxy_pass http://node_backend;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

注意：add_header 指令在 if 块中生效需确保 Nginx 版本 ≥ 1.7.0；若用旧版本，可改用 map + add_header 全局方式规避限制。