Node.js Koa 框架路由如何优化？现有手动引入路由写法优化求教

1. 消除手动注册路由的冗余，实现自动扫描注册 #

原有写法每新增一个路由模块就要手动在app.js里引入、挂载，新增路由还要修改入口文件，维护成本高。
优化方案：用fs模块自动遍历router目录下的所有路由文件，自动完成注册，后续新增路由只需在router目录下新建对应文件即可，无需修改app.js。

// app.js 优化后代码
'use strict';
const Koa = require("koa");
const fs = require('fs');
const path = require('path');
const app = new Koa();
const Router = require("koa-router");
const rootRouter = new Router();

// 路由自动注册逻辑
const ROUTER_DIR = path.join(__dirname, 'router');
fs.readdirSync(ROUTER_DIR)
  // 过滤非js文件，避免目录下的配置文件/临时文件被误加载
  .filter(file => file.endsWith('.js'))
  .forEach(file => {
    const router = require(path.join(ROUTER_DIR, file));
    rootRouter.use(router.routes(), router.allowedMethods());
  });

app.use(rootRouter.routes(), rootRouter.allowedMethods());
const port = 3000;
app.listen(port, () => console.log(`服务已启动，端口：${port}`));

2. 拆分路由层与控制层，职责解耦 #

原有写法把路由规则定义和业务处理逻辑耦合在同一个文件里，业务逻辑复杂后路由文件会变得臃肿难以维护。
优化方案：新增controller目录，所有业务处理逻辑抽离到控制层，路由文件仅负责定义路由规则、挂载中间件、绑定对应的控制器方法。

// controller/home.js 控制层示例
class HomeController {
  async index(ctx) {
    // 业务逻辑全部写在控制层，比如查询数据、参数校验等
    const pageData = { title: '首页' };
    await ctx.render("home", pageData);
  }
}
module.exports = new HomeController();

// router/home.js 路由层优化后代码
'use strict';
const router = require("koa-router")();
const HomeController = require('../controller/home');

// 路由只做规则定义和方法绑定
router.get("/", HomeController.index);
module.exports = router;

3. 路由前缀内聚管理，避免入口文件配置冗余 #

原有路由前缀统一在app.js的use方法中传入，所有路由的前缀散落在入口文件，查找修改成本高。
优化方案：在各个路由模块初始化Router实例时，直接传入prefix参数指定当前模块的路由前缀，入口文件无需再单独处理前缀。

// router/stuff.js 优化后代码，前缀内聚在当前路由文件管理
'use strict';
// 初始化时直接指定当前模块的路由前缀
const router = require("koa-router")({
  prefix: '/stuff'
});
const StuffController = require('../controller/stuff');

// 此处的/ 实际对应路由为 /stuff/
router.get("/", StuffController.index);
module.exports = router;

4. 路由分组挂载公共中间件，减少重复代码 #

原有写法如果多个路由需要相同的校验逻辑（比如登录校验、权限校验），需要在每个路由的回调里重复写逻辑。
优化方案：给同组路由统一批量挂载公共中间件，同组下的所有路由都会自动执行中间件逻辑，无需重复编写。

// router/admin.js 示例：所有后台路由统一加登录校验
'use strict';
// 引入登录校验中间件
const authMiddleware = require('../middleware/auth');
const router = require("koa-router")({
  prefix: '/admin'
});
const AdminController = require('../controller/admin');

// 该路由组下所有接口都会先经过登录校验
router.use(authMiddleware);
router.get("/dashboard", AdminController.dashboard);
router.post("/config", AdminController.updateConfig);
module.exports = router;

5. 可选优化：路由版本管理 #

如果是接口类服务，可以给不同版本的路由加统一的版本前缀，比如/v1、/v2，方便版本迭代时兼容旧版本接口。

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