options预检请求是浏览器在发送非简单跨域请求前自动发起的安全协商机制,用于确认服务器是否允许后续真实请求;它不传业务数据,仅通过origin、access-control-request-method等头与服务器交换cors策略。

OPTIONS 预检请求是浏览器在发送某些跨域请求前,自动发起的安全探查动作。它本身不传输业务数据,也不触发后端业务逻辑,纯粹由浏览器驱动,目的是确认“接下来这个真实请求,服务器是否允许我发”。理解它的作用,关键不是记住规则,而是看清它在安全与可用性之间的定位:它是同源策略的延伸,不是障碍,而是协商机制。
预检请求出现的明确条件
当跨域请求同时满足以下任一情况时,浏览器就会触发 OPTIONS 预检:
- 请求方法不是 GET、HEAD 或 POST(例如 PUT、DELETE、PATCH)
- 设置了自定义请求头(如 X-Auth-Token、Authorization、X-Request-ID 等)
-
Content-Type 值不是以下三者之一:
application/x-www-form-urlencoded、
multipart/form-data、
text/plain
(常见如 application/json 就会触发)
预检请求的核心交互逻辑
浏览器发出 OPTIONS 请求时,会带上三个关键请求头:
- Origin:当前页面所在源(协议+域名+端口),例如 https://admin.example.com
- Access-Control-Request-Method:后续真实请求将使用的 HTTP 方法,例如 POST
- Access-Control-Request-Headers:后续请求将携带的自定义头名列表,例如 Content-Type, X-User-ID
服务器必须响应这些字段,并在响应头中明确声明许可范围,否则浏览器直接拦截后续请求。
服务端必须返回的关键响应头
一个有效的预检响应至少需包含:
- Access-Control-Allow-Origin:指定允许的源(不能为 * 当带凭证时),如 https://admin.example.com
- Access-Control-Allow-Methods:列出允许的方法,如 GET, POST, PUT, DELETE, OPTIONS
- Access-Control-Allow-Headers:列出允许的请求头,须覆盖客户端所列,如 Content-Type, X-User-ID, Authorization
- Access-Control-Max-Age(可选但推荐):缓存预检结果的时间(秒),例如 86400 可避免重复 OPTIONS 请求
它不是 bug,也不是后端没配好
看到两次请求(OPTIONS + POST)不必怀疑代码或后端逻辑错误。这是浏览器主动执行的安全检查,发生在网络层,前端 JavaScript 无法跳过或取消。只要后端正确响应预检,整个流程对用户完全透明;若失败,则真实请求根本不会发出,控制台会报 CORS 错误而非网络超时。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











