在类中使用Express app.use失效问题排查及修复方案

问题现象 #

构建了WebServer抽象类用于统一初始化Express服务器的默认配置（包含API路由、helmet、morgan等），子类HTTPWebServer负责创建HTTP服务器。但实例化后出现以下异常：

• 仅/isalive接口可正常响应
• /api/root等API路由访问超时
• morgan无日志输出，helmet安全头未生效

问题根因 #

核心问题是函数调用拼写错误：
将解析JSON请求体的中间件调用express.json()误写为express.json（缺少调用括号）。

express.json是一个返回中间件函数的工厂函数，直接传递函数本身给app.use()时，Express会将其当作中间件执行，但该函数内部需要正确触发next()才能让请求流转到后续路由/中间件。由于未调用express.json()，实际传入的是未初始化的工厂函数，它不会调用next()，导致请求被永久挂起，只有在它之前定义的/isalive路由能正常处理请求。

修复方案 #

修改抽象类中_applyDefaultToExpressApp方法的代码，补全express.json的调用括号，同时优化中间件顺序（将请求解析、安全中间件放在路由前，符合Express执行逻辑）：

abstract class WebServer {
  private _app: Express;
  private _routers: IWebServerRoute[] = [];

  constructor() {
    this._applyDefaultToExpressApp();
  }

  private _applyDefaultToExpressApp() {
    this._app = express();
    // 请求体解析中间件（修复拼写错误）
    this._app.use(express.json()); // ✅ 补全函数调用括号
    this._app.use(
      express.urlencoded({
        extended: true,
      })
    );
    // 安全与日志中间件
    this._app.use(helmet());
    this._app.use(morgan("dev"));

    // 路由定义（放在中间件之后）
    this._app.get("/isalive", (_, res: Response) => res.status(200).json({ status: "I'm alive" }));
    const apiRouter = Router();
    apiRouter.get("/root", (_, res: Response) => res.status(200).json({ status: "from api root" }));
    this._app.use("/api", apiRouter);
  }

  public get app(): Express {
    return this._app;
  }

  abstract createWebServer(serverOptions: http.ServerOptions | https.ServerOptions): http.Server | https.Server;
}

验证结果 #

修复后：

• /api/root接口可正常返回响应
• morgan会在控制台输出请求日志
• helmet自动添加的安全头会出现在响应中

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