CORS 预检 (Preflight)

OPTIONS 预检何时触发、检查哪些头部,逐步可视化。ACRM/ACRH 与服务器 Allow-* 的对应关系一目了然。

场景预设

请求 — 浏览器(页面)侧

Method

Content-Type

自定义头部

Access-Control-Request-Headers: content-type, x-api-key

响应 — 服务器返回的头部

Access-Control-Allow-Origin

Access-Control-Allow-Methods

Access-Control-Allow-Headers

请求所需 + 常用头部 — 点击切换

浏览器处理步骤

→

页面发起 fetch 请求

•

非简单请求 — 需要 OPTIONS 预检

→

发送 OPTIONS 预检请求

OPTIONS /data HTTP/1.1
Origin: https://myapp.example.com
Access-Control-Request-Method: POST
Access-Control-Request-Headers: content-type, x-api-key
←

服务器预检响应到达

HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://myapp.example.com
Access-Control-Allow-Methods: GET, POST, PUT
Access-Control-Allow-Headers: content-type, x-api-key
✓

Allow-Origin 与来源一致 — 通过

✓

请求方法在 Allow-Methods 中 — 通过

✓

请求头部全部在 Allow-Headers 中 — 通过

—

未携带凭据 — 跳过检查

✓

预检通过 — 进入正式请求

→

发送正式请求

POST /data HTTP/1.1
Origin: https://myapp.example.com
Content-Type: application/json
X-Api-Key: s3cr3t
←

服务器正式响应到达

HTTP/1.1 200 OK
Access-Control-Allow-Origin: https://myapp.example.com

{"status": "ok"}
✓

Allow-Origin 与来源一致 — 通过

✓

响应已传递给 JavaScript — 成功

浏览器控制台

▸ 响应已成功传递给 JavaScript 代码。

修改任意值,下方步骤会立即重新计算。试试「credentials + *」场景看通配符为何被拦。

请求不满足「简单」条件时,浏览器先发 OPTIONS 预检:用 Access-Control-Request-Method/Headers 声明将用的方法和头部,相当于事先请示。

服务器需用三个头应答:Allow-Origin、Allow-Methods、Allow-Headers。任何一项不覆盖请求,正式请求都不会发出。

预检每次都有延迟,用 Access-Control-Max-Age 让浏览器缓存结果是常规优化,PUT/DELETE 或 Authorization API 尤其需要。 CORS 模拟器

常见问题

什么情况触发预检?
非 GET/HEAD/POST 方法、safelist 外头部(Authorization、X- 自定义)、application/json 等非简单 Content-Type,任一即可。
服务器对 OPTIONS 返回 404 怎么办?
路由没处理 OPTIONS。用 CORS 中间件自动应答,或自己开 OPTIONS 路由返回 204 + Allow-* 头。

其他场景