Node.js / 系统课时
配置跨域与静态资源
配置跨域与静态资源
浏览器前端与 API 不同源时,需要由服务端返回正确的 CORS 响应头;图片、CSS、前端脚本等静态文件则可以直接交给 express.static。本节把两者分开配置,避免把跨域策略和文件目录映射混在一起。
学习目标
- 为指定前端源配置
cors中间件并理解预检请求 - 用虚拟 URL 前缀挂载
express.static - 用
curl验证 CORS 响应头和静态文件访问路径
把 CORS 限定在 API 路径
CORS 由浏览器执行,服务端只是返回 Access-Control-* 响应头;它不是鉴权机制。下面把策略挂在 /api,只允许 https://app.example.com 读取 API,并允许浏览器携带凭据。使用凭据时不要把允许源配置成 *。
复杂跨域请求会先发送 OPTIONS 预检。将 cors(corsOptions) 作为 /api 的应用级中间件时,cors 会处理该路径下的预检请求,不必再为每个接口手写 OPTIONS 路由。
同时挂载 API 与静态目录
下面示例适用于 Express 5.x,并使用 cors 2.8.x。项目需已安装 express 和 cors,并将示例保存为 app.mjs。静态目录使用基于当前模块位置计算出的绝对路径,避免因为从不同工作目录启动 Node.js 而找错 public。
import express from 'express';
import cors from 'cors';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
const app = express();
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
const publicDir = path.join(__dirname, 'public');
const corsOptions = {
origin: 'https://app.example.com',
credentials: true,
methods: ['GET', 'POST'],
allowedHeaders: ['Content-Type', 'Authorization'],
};
app.use('/api', cors(corsOptions));
app.use('/api', express.json());
app.get('/api/status', (req, res) => {
res.json({ ok: true });
});
app.use('/static', express.static(publicDir));
app.listen(3000, () => {
console.log('server listening on 3000');
});预期结果:执行 node app.mjs 启动后,/api/status 由 CORS 策略保护浏览器读取权限,public/logo.svg 则映射为 /static/logo.svg;URL 中不会出现 public 目录名。
server listening on 3000
验证预检响应头
先模拟浏览器预检,请求里给出 Origin、目标方法和目标请求头。下面响应只列与验证有关的关键头,实际响应还会包含其他标准头。
curl -i -X OPTIONS http://localhost:3000/api/status -H "Origin: https://app.example.com" -H "Access-Control-Request-Method: GET" -H "Access-Control-Request-Headers: Authorization"预期输出的关键部分如下。
HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://app.example.com
Access-Control-Allow-Credentials: true
Access-Control-Allow-Methods: GET,POST
Access-Control-Allow-Headers: Content-Type,Authorization若把 Origin 改成未允许的站点,cors 不会返回允许该源的 CORS 头;这不代表服务器实现了访问控制,非浏览器客户端仍可请求接口,所以敏感接口必须另做认证与授权。
验证静态文件映射
在项目的 public 目录放入 logo.svg 后,请求 /static/logo.svg。express.static 的 root 决定磁盘根目录,而 /static 是 URL 挂载前缀,两者不要重复写成 /static/public/logo.svg。
curl -i http://localhost:3000/static/logo.svg预期结果:文件存在时返回 200,并带有与 SVG 对应的内容类型;下面只列关键响应头,实际响应还包含其他标准头与 public/logo.svg 的正文。
HTTP/1.1 200 OK
Content-Type: image/svg+xml如果静态文件访问频繁,可在生产环境前增加 CDN 或反向代理缓存;应用层仍应使用明确的挂载前缀和绝对目录,避免暴露不该公开的项目文件。