如何在Express应用中将配置值从app.js传递到独立路由文件

本文将介绍一种简洁且可维护的 Express 开发模式——通过函数式导出（function-based export），将全局配置（如 API 基础 URL）从主应用文件安全、显式地注入到模块化路由文件中，彻底告别全局变量和重复定义带来的困扰，提升代码可维护性。

在 Express 多路由项目中，为保持代码清晰易维护，开发者通常将路由逻辑拆分为独立文件（如 routes/test.js），并通过 app.use() 挂载。然而，当多个路由需共用同一配置（如 url = "https://example.com/v1"）时，若直接在路由文件中硬编码，会破坏单一数据源原则；若使用全局变量（如 global.url），则违背模块封装性，导致测试和扩展困难。

如何解决？推荐采用工厂函数模式（Factory Function Pattern）：将路由模块导出为一个接收配置参数的函数，返回配置完成的 Router 实例。此方案使依赖关系显式化，便于灵活复用和单元测试，是 Express 中管理配置传递的推荐方式。

✅ 标准实现方式如下：

app.js 中初始化并传入参数：

const express = require("express");
const app = express();
const port = 3000;
const url = "https://example.com/v1";

// 将 url 作为参数传入路由工厂函数
const testRouter = require("./routes/test")(url);

app.use(express.json());
app.use("/test", testRouter); // 注意：必须调用 app.use() 挂载路由

app.listen(port, () => {
  console.log(`Example app listening on port ${port}`);
});

routes/test.js 中定义可配置路由模块：

const express = require("express");
const router = express.Router();

// 导出工厂函数，接收外部配置
module.exports = (baseUrl) => {
  // 可选：添加共享中间件（如日志）
  router.use((req, res, next) => {
    console.log("[Test Router] Time:", Date.now());
    next();
  });

  // 使用传入的 baseUrl
  router.post("/", (req, res) => {
    console.log("Base URL used:", baseUrl);
    res.json({ success: true, apiBaseUrl: baseUrl });
  });

  return router; // 必须返回配置后的 router 实例
};

⚠️ 关键注意事项：

• 路由文件必须导出函数（而非直接导出 router），否则参数无法传递；
• app.use() 的挂载语句不可省略，且路径前缀（如 /test）应与业务语义保持一致；
• 若共享值不止一个（如 url、timeout、authToken），可统一打包为配置对象传入：require("./routes/test")({ url, timeout: 5000 });
• 该模式天然支持环境隔离——开发环境与生产环境传入不同 baseUrl，无需条件判断。

这套方案兼顾模块化、可测试性与可读性，是 Express 官方文档推荐的高级组织方式之一，尤其适合中大型项目在持续演进中使用。