如何在Koa.js中为所有响应预设指定HTTP请求头？

嘿，我之前从Express转Koa的时候也做过这个转换，其实思路和Express的中间件逻辑一致，只是Koa的上下文对象结构稍有不同，下面给你两种实现方式：

方式一：自定义中间件（手动实现） #

直接写一个Koa中间件来设置这些响应头，完全对应你之前的Express代码逻辑：

app.use(async (ctx, next) => {
  // 设置允许跨域的源，对应Express里的res.header('Access-Control-Allow-Origin', '*')
  ctx.set('Access-Control-Allow-Origin', '*');
  // 设置允许的请求头列表
  ctx.set('Access-Control-Allow-Headers', 'Origin, X-Requested-With, Content-Type, Accept');
  // 设置允许的HTTP请求方法
  ctx.set('Access-Control-Allow-Methods', 'POST, GET, PUT, DELETE, OPTIONS');

  // 专门处理OPTIONS预检请求：浏览器发送复杂跨域请求前会先发OPTIONS，直接返回204即可
  if (ctx.method === 'OPTIONS') {
    ctx.status = 204;
    return;
  }

  // 把控制权传递给下一个中间件/路由
  await next();
});

关键点说明： #

• Koa用ctx（上下文对象）整合了请求和响应，所以用ctx.set()替代Express的res.header()来设置响应头
• 必须用await next()：Koa2默认基于async/await的异步中间件，这一步是把流程交给后续的中间件或路由处理
• 额外处理OPTIONS请求：这是跨域预检请求的标准处理方式，避免不必要的路由执行

方式二：使用成熟的第三方包（推荐生产环境） #

如果不想自己手动处理细节，可以用官方维护的@koa/cors包，它能覆盖更多边缘场景：

首先安装包：

npm install @koa/cors

然后在代码中引入并配置：

const cors = require('@koa/cors');

app.use(cors({
  origin: '*',
  allowHeaders: ['Origin', 'X-Requested-With', 'Content-Type', 'Accept'],
  allowMethods: ['POST', 'GET', 'PUT', 'DELETE', 'OPTIONS']
}));

这个包会自动处理预检请求、动态源匹配等细节，比手动写更可靠。

内容的提问来源于stack exchange，提问作者Gherman