CORS 跨域机制与跨域请求处理

允许指定前端读取跨域接口,并正确处理预检与 Cookie 凭据

🎯 引言

学完这篇文章,你能允许指定前端读取跨域接口,并配置预检和携带 Cookie 的请求。

🌐 CORS 决定浏览器能否读取响应

页面在 http://localhost:5173,接口在 http://127.0.0.1:3000,二者不同源。后端使用 CORS 响应头告诉浏览器哪些来源可以读取响应。

Express 项目使用 cors 中间件生成这些响应头并处理预检。安装本节需要的依赖:

npm install cors@2.8.6

新建 cors-server.mjs:

cors-server.mjs
import express from 'express';
import cors from 'cors';

const app = express();

🏷 配置允许的前端来源

在路由之前配置:

cors-server.mjs
app.use(cors({
    origin: 'http://localhost:5173',
    methods: ['GET', 'POST', 'PATCH'],
    allowedHeaders: ['Content-Type', 'Authorization']
}));

origin 是允许读取的页面来源,必须包含实际的协议、主机和端口。methods 声明允许的请求方法;allowedHeaders 声明预检允许的自定义请求头。

这份配置会返回指定的允许来源。其他来源的浏览器页面无法据此读取响应,但请求仍可能到达服务器;CORS 不能替代身份认证和 CSRF 防护。


📤 添加接口并启动

继续添加测试接口:

cors-server.mjs
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 时,将前面的 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 仍能看到正文、浏览器页面却无法读取的差别。

// 请在这里记录结果