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。

js
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 目录名。

text
server listening on 3000

浏览器跨域访问 API 与静态文件挂载的两条请求路径

验证预检响应头

先模拟浏览器预检,请求里给出 Origin、目标方法和目标请求头。下面响应只列与验证有关的关键头,实际响应还会包含其他标准头。

bash
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"

预期输出的关键部分如下。

text
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。

bash
curl -i http://localhost:3000/static/logo.svg

预期结果:文件存在时返回 200,并带有与 SVG 对应的内容类型;下面只列关键响应头,实际响应还包含其他标准头与 public/logo.svg 的正文。

text
HTTP/1.1 200 OK
Content-Type: image/svg+xml

如果静态文件访问频繁,可在生产环境前增加 CDN 或反向代理缓存;应用层仍应使用明确的挂载前缀和绝对目录,避免暴露不该公开的项目文件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置跨域与静态资源

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通