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 模拟器