CORS 跨域调试器

填写页面来源、请求方法、自定义请求头和是否携带 Cookie,再粘贴从开发者工具里复制的响应头,工具会按浏览器的规则逐项检查,告诉你会不会触发 OPTIONS 预检、哪一步没通过、控制台报错是什么意思,并生成 Nginx、Express、Spring Boot、Go、PHP 的正确跨域配置。

在开发者工具“网络”面板中找到失败的请求(预检请求类型为 preflight 或方法为 OPTIONS),在“标头 / Headers”里复制响应头粘贴进来。

服务器跨域配置

浏览器的跨域规则

  • 什么是跨域:协议、域名、端口有一个不同就是不同来源。https://app.example.com 请求 https://api.example.com 就是跨域,浏览器会按 CORS 规则检查响应头,不合格就不把响应交给 JavaScript。服务器其实已经收到并处理了请求。
  • 简单请求:方法是 GET、HEAD、POST,且只带 Accept、Content-Language 等安全请求头,Content-Type 只能是表单或 text/plain。满足就直接发送,不需要预检。
  • 预检请求:用了 PUT、DELETE,或带 Authorization、自定义头、Content-Type: application/json,浏览器会先发 OPTIONS 请求询问服务器是否允许,响应必须是 2xx 且包含允许的来源、方法和请求头。
  • 携带 Cookie:Allow-Origin 不能写 *,必须写具体的来源,并返回 Access-Control-Allow-Credentials: true;Allow-Methods、Allow-Headers 的 * 在这种情况下也不生效。
  • 读取响应头:JavaScript 默认只能读到 Content-Type 等少数响应头,想读自定义头(如分页总数)要在 Access-Control-Expose-Headers 中列出。
  • 多个来源:Allow-Origin 只能写一个值,要允许多个域名时由服务器判断请求的 Origin 是否在白名单里,再原样返回,并加上 Vary: Origin 防止缓存串用。

本工具按规范模拟浏览器的检查,不会真的发出请求;Chrome 的私有网络访问(从公网页面访问内网地址)等额外限制不在检查范围内。

CORS 跨域调试器常见问题

CORS 跨域调试器怎么使用?

填写页面来源(Origin)、请求地址、方法、Content-Type、其他请求头和要读取的响应头,勾选是否携带 Cookie;把预检 OPTIONS 和正式请求的响应头分别粘贴进来,右侧逐项显示检查结果和对应的控制台报错;下方切换服务器类型复制跨域配置。

什么情况下会发 OPTIONS 预检请求?

使用 PUT、DELETE 等方法,或带 Authorization、自定义头、Content-Type: application/json 时,浏览器会先发 OPTIONS 预检。

携带 Cookie 时 Allow-Origin 能写 * 吗?

不能,必须写具体的来源,并同时返回 Access-Control-Allow-Credentials: true。

前端为什么读不到自定义响应头?

需要服务器在 Access-Control-Expose-Headers 中列出该响应头。

允许多个域名跨域怎么配?

服务器判断请求的 Origin 是否在白名单中,在就原样返回到 Allow-Origin,并加上 Vary: Origin。

CORS 跨域调试器的结果应怎样理解?

按 Fetch 规范模拟浏览器的 CORS 检查,不会真的发出请求;不包含 Chrome 私有网络访问等额外限制;生成的配置需按实际项目调整来源白名单。

输入内容会保存或发给外部服务吗?

所有内容只在浏览器本地分析,不会上传。

没有结果或操作失败时先检查什么?

预检返回 401 或 404,通常是 OPTIONS 被登录拦截或没有对应路由,需要让 OPTIONS 直接返回 204;出现两个 Access-Control-Allow-Origin,说明 Nginx 和后端都加了跨域头。

相关工具

JSON 格式化校验 · Base64 编码解码 · URL 编码解码 · JWT 解码与验证 · 全部开发工具