Skip to content

CORS 深入

理解跨源资源共享:预检请求、头和凭证处理。

你将学到

  • 同源策略和 CORS 为何存在
  • 简单请求与预检请求
  • CORS 头:Origin、Access-Control-Allow-Origin
  • 带凭证请求和通配符限制

概念讲解

CORS 深入

跨源资源共享(CORS)允许网页从不同源请求资源,绕过同源策略。

同源策略

SOP 阻止一个源的脚本读取另一个源的响应。源是 scheme+host+port。CORS 允许特定跨源请求。

简单与预检

简单请求(GET/HEAD/POST 加安全头)直接发送。预检请求(PUT/DELETE、自定义头)先发 OPTIONS 再发实际请求。

CORS 头

Allow-Origin:可读响应的源。Allow-Methods:允许的方法。Allow-Headers:允许的头。Max-Age:预检缓存时长。服务器设,浏览器执行。

凭证

默认 CORS 不发 cookie。发凭证:fetch(url, {credentials:'include'}) 和 Allow-Credentials:true。有凭证时 Allow-Origin 不能是 *——必须特定源。

示例代码

              function corsMW(req, res, next) {
  const origins = ['https://app1.example.com', 'https://app2.example.com'];
  if (origins.includes(req.headers.origin)) {
    res.setHeader('Access-Control-Allow-Origin', req.headers.origin);
    res.setHeader('Access-Control-Allow-Credentials', 'true');
    res.setHeader('Access-Control-Allow-Methods', 'GET,POST,PUT,DELETE,OPTIONS');
    res.setHeader('Access-Control-Allow-Headers', 'Content-Type,Authorization');
    res.setHeader('Access-Control-Max-Age', '86400');
  }
  if (req.method === 'OPTIONS') return res.status(204).end();
  next();
}
const req = {headers:{origin:'https://app1.example.com'}, method:'OPTIONS'};
const res = {headers:{}, setHeader(k,v){this.headers[k]=v;}, status(c){console.log('Status:',c);return this;}, end(){console.log('Headers:',res.headers);}};
corsMW(req, res, () => console.log('Not preflight'));
            

中间件为允许的源设 CORS 头。OPTIONS 预检返回 204 带头。带凭证请求需特定源(非 *)。

动手试一试

  • JSON Formatter

    CORS 预检响应用 JSON 配置——格式化头用于调试。

常见错误

错误写法

带凭证设 Allow-Origin: *。

正确做法

Allow-Credentials 为 true 时源必须特定,非 *。回显 Origin 头。

错误写法

不处理 OPTIONS 预检请求。

正确做法

服务器必须用 204 和 CORS 头响应 OPTIONS。否则预检失败。

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

动手做项目

通过引导式项目应用所学,含起始代码与解决方案。

查看项目

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误