Express路由懒加载问题：启动预加载而非按需加载

你当前的代码问题在于：app.get('/collections', getRoute('collections'))在应用启动时就会直接执行getRoute('collections')，导致模块被提前加载，而非请求触发时加载。要实现真正的按需加载，需要将模块加载逻辑延迟到请求处理阶段。

解决方案：返回中间件延迟加载模块 #

修改getRoute函数，让它返回一个Express中间件函数，只有当请求匹配到对应路由时，才执行模块加载和处理逻辑：

同步加载方案（适配CommonJS/TypeScript CommonJS输出） #

import { Router, Request, Response, NextFunction } from 'express';

const app = Router();

app.get('/collections', getRoute('collections'));
// 其他路由注册...

function getRoute(route: string): (req: Request, res: Response, next: NextFunction) => void {
  const [path, func = 'default'] = route.split(':');

  return (req, res, next) => {
    try {
      console.log(`getting route: ${path}`);
      // 请求触发时才加载模块
      const handler = require(`./${path}`)[func];
      // 执行路由处理函数
      handler(req, res, next);
    } catch (err) {
      // 捕获模块加载或执行错误，交给Express错误处理中间件
      next(err);
    }
  };
}

异步加载方案（适配ES模块/TypeScript ES模块输出） #

如果你的项目使用ES模块（"module": "ESNext"在tsconfig.json中），可以用异步import()实现加载，同时处理异步逻辑：

import { Router, Request, Response, NextFunction } from 'express';

const app = Router();

app.get('/collections', getRoute('collections'));
// 其他路由注册...

function getRoute(route: string): (req: Request, res: Response, next: NextFunction) => Promise<void> {
  const [path, func = 'default'] = route.split(':');

  return async (req, res, next) => {
    try {
      console.log(`getting route: ${path}`);
      // 异步加载模块
      const routeModule = await import(`./${path}`);
      const handler = routeModule[func as keyof typeof routeModule];
      // 执行路由处理函数
      handler(req, res, next);
    } catch (err) {
      next(err);
    }
  };
}

关键原理说明 #

• 原代码中getRoute直接返回模块导出的处理函数，导致启动时立即执行require加载模块；
• 修改后getRoute返回一个待执行的中间件函数，只有当请求到达对应路由时，这个中间件才会被调用，此时才会执行模块加载和处理逻辑，实现真正的按需加载。

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