如何在Koa中仅为特定路由配置静态文件夹服务？

其实这个问题很常见，koa-static本身默认是全局挂载的，但我们可以通过更优雅的方式实现特定路由的静态服务，比你手动写路径判断要健壮得多，下面给你两种可行方案，优先推荐第一种：

方案一：结合koa-router挂载（推荐） #

这是最标准的做法，利用koa-router的路由分组能力，把koa-static挂载到指定路由下，自动处理所有子路径的匹配：

步骤： #

1. 先安装依赖（如果还没装的话）：

   npm install koa koa-static koa-router
   

2. 编写代码：

   const Koa = require('koa');
   const serve = require('koa-static');
   const Router = require('koa-router');
   
   const app = new Koa();
   const router = new Router();
   
   // 给/dashboard路由及其所有子路径挂载静态服务
   router.use('/dashboard', serve('./build'));
   
   // 处理其他路由
   router.get('/', async (ctx) => {
     ctx.body = '欢迎访问首页！';
   });
   
   // 把路由中间件挂载到Koa实例上
   app.use(router.routes()).use(router.allowedMethods());
   
   app.listen(3000, () => {
     console.log('服务启动在http://localhost:3000');
   });
   

为什么推荐这个方案？ #

• 自动处理所有子路径：比如访问/dashboard/index.html、/dashboard/css/style.css这类子路径时，都会正确映射到./build文件夹下的对应文件
• 路由逻辑更清晰：和其他路由规则统一管理，便于维护
• 不需要手动处理路径替换、状态判断等细节，避免出错

方案二：手动编写中间件过滤路径（无路由依赖） #

如果不想引入koa-router，也可以自己写一个中间件来过滤路径，再调用koa-static：

const Koa = require('koa');
const serve = require('koa-static');

const app = new Koa();
// 先初始化静态服务中间件
const dashboardStatic = serve('./build');

app.use(async (ctx, next) => {
  // 判断当前请求路径是否以/dashboard开头
  if (ctx.path.startsWith('/dashboard')) {
    // 临时修改请求路径，去掉/dashboard前缀，让静态中间件正确查找文件
    const originalPath = ctx.path;
    ctx.path = ctx.path.replace(/^\/dashboard/, '');
    
    // 调用静态中间件
    await dashboardStatic(ctx, () => {});
    
    // 恢复原路径，避免影响后续中间件
    ctx.path = originalPath;
    
    // 如果静态中间件已经返回了有效内容（状态码不是404），就跳过后续中间件
    if (ctx.status !== 404) return;
  }
  // 不符合条件的请求，继续走后续中间件
  await next();
});

// 处理其他请求
app.use(async (ctx) => {
  ctx.body = '这是非dashboard路由的响应';
});

app.listen(3000);

注意点： #

这种方法需要自己处理路径替换和状态判断，如果你有多个特定路由需要挂载静态服务，代码会变得繁琐，所以只适合简单场景。

另外，你之前尝试的手动判断ctx.path === '/dashboard'的写法有个问题：只能匹配/dashboard这个根路径，无法匹配它的子路径（比如/dashboard/js/app.js），所以实用性不高。

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