CORS 跨域机制与跨域请求处理
🎯 引言
学完这篇文章,你能允许指定前端读取跨域接口,并配置预检和携带 Cookie 的请求。
🌐 CORS 决定浏览器能否读取响应
页面在 http://localhost:5173,接口在 http://127.0.0.1:3000,二者不同源。后端使用 CORS 响应头告诉浏览器哪些来源可以读取响应。
Express 项目使用 cors 中间件生成这些响应头并处理预检。安装本节需要的依赖:
npm install cors@2.8.6
新建 cors-server.mjs:
import express from 'express';
import cors from 'cors';
const app = express();
🏷 配置允许的前端来源
在路由之前配置:
app.use(cors({
origin: 'http://localhost:5173',
methods: ['GET', 'POST', 'PATCH'],
allowedHeaders: ['Content-Type', 'Authorization']
}));
origin 是允许读取的页面来源,必须包含实际的协议、主机和端口。methods 声明允许的请求方法;allowedHeaders 声明预检允许的自定义请求头。
这份配置会返回指定的允许来源。其他来源的浏览器页面无法据此读取响应,但请求仍可能到达服务器;CORS 不能替代身份认证和 CSRF 防护。
📤 添加接口并启动
继续添加测试接口:
app.get('/profile', (req, res) => {
res.json({ name: '小明' });
});
app.listen(3000, '127.0.0.1');
运行 node cors-server.mjs。从来源 http://localhost:5173 的页面请求 /profile,浏览器可以读取 {"name":"小明"}。允许的方法列表不会自动创建 POST 或 PATCH 业务接口。
📣 预检由中间件处理
带 Authorization 或 JSON 正文等跨域请求可能先发送 OPTIONS,询问实际请求的方法与请求头是否被允许。
检查预检响应:
curl -i -X OPTIONS http://127.0.0.1:3000/profile -H 'Origin: http://localhost:5173' -H 'Access-Control-Request-Method: PATCH' -H 'Access-Control-Request-Headers: content-type'
应得到 204,以及允许来源、方法和请求头。cors 放在应用前部时会处理这类预检,不需要为它再写一套路由。
curl 不执行浏览器的同源限制,只适合检查响应内容;判断页面是否可读,还要在浏览器中验证。
🍪 携带 Cookie 要同时配置两端
需要携带登录 Cookie 时,将前面的 cors 配置替换为:
app.use(cors({
origin: 'http://localhost:5173',
credentials: true,
methods: ['GET', 'POST', 'PATCH'],
allowedHeaders: ['Content-Type', 'Authorization']
}));
credentials: true 让响应带上允许凭据的头。此时来源要明确指定,不能用 *。
浏览器端请求也需要开启凭据:
fetch('http://127.0.0.1:3000/profile', { credentials: 'include' });
Cookie 是否实际携带还受 Domain、SameSite、Secure 和浏览器第三方 Cookie 策略影响。生产环境通常通过 HTTPS 和明确的站点部署关系配置它们,CORS 不会覆盖 Cookie 自身的限制。
❓ 知识问答
Q1:为什么 Postman 可以请求,浏览器却报跨域?
桌面接口工具不执行浏览器的读取限制,需要检查实际页面来源与 CORS 配置是否一致。
Q2:只配置预检响应够吗?
不够,实际响应也需要许可头。把 cors 挂在路由之前,可以覆盖这两个阶段。
Q3:不允许某个来源,是否就阻止了它修改数据?
不能这样判断。需要服务端在修改前进行认证、权限与 CSRF 检查。
🧪 小练习
将 origin 改成其他端口,比较 curl 仍能看到正文、浏览器页面却无法读取的差别。
// 请在这里记录结果
