Express 支持通过 app.use(path, router) 将 Router 挂载到特定子路径，并为其绑定专属中间件，从而实现同级 API 路径（如 /api/one 和 /api/two）各自拥有独立认证逻辑，避免中间件全局污染。
express 支持通过 `app.use(path, router)` 将 router 挂载到特定子路径，并为其绑定专属中间件，从而实现同级 api 路径（如 `/api/one` 和 `/api/two`）各自拥有独立认证逻辑，避免中间件全局污染。
在 Express 应用中，若希望 /api/one 和 /api/two 这类共享 /api 前缀的路由使用完全隔离的中间件栈（例如不同的身份验证策略、日志方式或请求预处理逻辑），关键在于正确挂载 Router 实例——必须指定精确的挂载路径，而非将 Router 直接挂载到根路径（app.use(router)）。否则，所有 Router 都会响应所有请求，导致中间件叠加执行，正如原始代码中访问 /api/two 时也触发了 one 的中间件。
正确的做法是：每个 Router 内部定义相对路径（如 router.get("/", ...)），再通过 app.use("/api/one", one) 显式挂载到对应子路径。此时 Express 会自动剥离挂载前缀，仅将剩余路径（如 /）交由该 Router 处理，其内部中间件也仅作用于该子树。
以下为优化后的完整示例：
const express = require("express");
const app = express();
const port = 4000;
// Router 1: 专用于 /api/one
const one = express.Router();
one.use((req, res, next) => {
console.log("[Middleware ONE] Auth via JWT or API key");
// 示例：校验 Authorization header 或 query token
next();
});
one.get("/", (req, res) => {
console.log("Handling /api/one → returning 'one'");
res.json({ result: "one", from: "Router ONE" });
});
// Router 2: 专用于 /api/two
const two = express.Router();
two.use((req, res, next) => {
console.log("[Middleware TWO] Auth via session or OAuth2");
// 示例：检查 req.session 或 req.user
next();
});
two.get("/", (req, res) => {
console.log("Handling /api/two → returning 'two'");
res.json({ result: "two", from: "Router TWO" });
});
// 主路由
app.get("/", (req, res) => {
res.send("Hello World!");
});
// ✅ 关键：挂载时指定完整前缀路径
app.use("/api/one", one); // 仅 /api/one/* 匹配此 Router
app.use("/api/two", two); // 仅 /api/two/* 匹配此 Router
app.listen(port, () => {
console.log(`✅ Example app listening on port ${port}`);
});
运行效果验证：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 访问
GET /api/one→ 输出[Middleware ONE] ...+"one" - 访问
GET /api/two→ 输出[Middleware TWO] ...+"two" - 两者中间件互不干扰，完全解耦。
⚠️ 注意事项：
- Router 内部的路径（如
one.get("/", ...)）始终是相对于挂载点的相对路径；不要重复写/api/one。 - 若需统一
/api前缀管理，可进一步封装：app.use("/api", apiRouter)，再在apiRouter中嵌套apiRouter.use("/one", one)—— 但需注意嵌套层级对中间件作用域的影响。 - 中间件顺序严格遵循挂载顺序与 Router 内部
use()顺序，建议将认证类中间件置于路由定义之前。
这种模式不仅解决了多认证策略共存问题，还提升了代码组织性与可维护性，是构建模块化 Express API 的推荐实践。
