CORS 头生成
来源白名单 + 允许方法/头 + 预检示例 + 冲突体检
预检只会在「非简单请求」时发生:用了 GET/POST/HEAD 以外的方法,或者请求头超出 Content-Type、Accept、Accept-Language、Content-Language 这几个白名单,都会先发一次 OPTIONS。
如何使用本工具
- 先选来源模式:单域名固定、按白名单动态回显、或直接放行任意来源。
- 勾选允许的方法与请求头;自己加的 X- 头写在「额外允许头」里,多个用逗号分隔。
- 右侧即时生成 Access-Control-* 响应头,并给出冲突提示,例如 * 配凭据、多来源写列表、Max-Age 超过浏览器上限。
- 下方是完整的 OPTIONS 预检请求与响应示例,可以直接复制给后端或网关同学对照配置。
常见问题
Q:为什么 Access-Control-Allow-Origin 不能写多个域名?
A:规范只允许它取「单个来源」或通配符 *。想放开多个来源,必须由服务端读请求的 Origin 头,比对白名单后把命中的那一个原样写回去,同时加 Vary: Origin,否则 CDN 可能把 A 站的响应缓存后发给 B 站。
Q:为什么 * 和 credentials 不能同时用?
A:这是浏览器的硬性限制。带 Cookie 的跨域请求如果允许任意来源,等于任何站点都能以用户身份读取数据,所以规范明确禁止这个组合。凭据模式必须回显具体来源,前端还要写 credentials: 'include'。
Q:什么时候会发 OPTIONS 预检?
A:只要不是「简单请求」就会发。简单请求限定为 GET / POST / HEAD,且手写的请求头只能是 Accept、Accept-Language、Content-Language、Content-Type,并且 Content-Type 限于 three 个表单相关值。用了 PUT、自定义 Authorization 头、application/json 都会触发预检。
Q:Access-Control-Max-Age 设多大合适?
A:它决定预检结果能缓存多久,缓存期内不再重复发 OPTIONS。Chrome 上限是 7200 秒(2 小时),Firefox 更宽松但也有上限。常见做法是 600~3600 秒,接口调试期可以设小一点,方便改配置后快速生效。
Q:配置都对,浏览器还是报跨域错误?
A:按顺序查四处:一是响应里到底有没有 Access-Control-Allow-Origin(DevTools Network 看实际响应头,不是看代码);二是网关或鉴权中间件是否把 OPTIONS 拦成了 401;三是带凭据时来源是否回显了具体域名;四是前端读自定义响应头时有没有写进 Expose-Headers。