Express 中路由顺序和通配符路径（如 /api/budget/:year）会优先匹配更宽泛的模式，导致 /api/budget/search 被误认为是年份参数而落入错误处理器，造成函数不执行、无日志、返回空数组。
express 中路由未执行：路径匹配优先级导致请求被错误捕获
在 Express 应用中，路由匹配遵循自上而下、先到先得的原则，且具有参数化路径（如 /api/budget/:year）会匹配任意非斜杠字符串——包括字面量 search。这意味着，尽管你定义了 /api/budget/search，但若其上方存在更宽泛的动态路由（如 /api/budget/:year），该请求将被前者捕获，后续路由（包括你的搜索逻辑）根本不会执行。
观察你提供的路由列表：
app.get("/api/budget/:year", verify, async (req, res) => {...});
// ...
app.get("/api/budget/search", verify, async (req, res) => {...});由于 /api/budget/:year 出现在 /api/budget/search 之前，当客户端请求 /api/budget/search 时，Express 将 search 解析为 :year 的值（即 req.params.year === "search"），直接进入该处理器，跳过后续所有 /api/budget/* 路由——这正是为何控制台无 console.log(req.query.q) 输出、返回空数组且状态码仍为 200（因该路由本身可能返回了默认响应或空数据）。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
✅ 正确做法：将具体、静态的路由置于动态、通配符路由之前。调整顺序如下：
// ✅ 静态路由优先（精确匹配）
app.get("/api/budget/search", verify, async (req, res) => {
console.log("Search route executed — q =", req.query.q);
try {
const users = await db
.collection("users")
.find({ username: { $regex: req.query.q || "", $options: "i" } })
.toArray();
// 安全移除敏感字段（推荐使用 projection 替代遍历删除）
const sanitized = users.map(({ password, ...rest }) => rest);
res.json(sanitized);
} catch (err) {
console.error("Search error:", err);
res.status(500).json({ error: "Internal server error" });
}
});
// ✅ 其他静态或高优先级子路径（如 /api/budget/whoami）也应前置
// ❌ 动态路由后置（宽泛匹配放最后）
app.get("/api/budget/:year", verify, async (req, res) => {
const year = parseInt(req.params.year, 10);
if (isNaN(year) || year < 1970 || year > 2100) {
return res.status(400).json({ error: "Invalid year" });
}
// ... 处理年份逻辑
});
app.get("/api/budget/:year/:month", verify, async (req, res) => { /* ... */ });
app.get("/api/budget/:year/:month/:id", verify, async (req, res) => { /* ... */ });? 关键注意事项：
- 路由顺序即执行顺序：Express 不做“最长前缀匹配”或“最优匹配”，仅按定义顺序逐条比对。
- 避免歧义路径：/api/budget/:year 与 /api/budget/search 语义冲突，建议将搜索接口独立命名（如 /api/users/search 已验证有效），或统一归入 /api/search 命名空间。
- 增强健壮性：在动态路由中加入参数校验（如 year 是否为合法数字），防止意外匹配；对数据库查询添加 try/catch 并显式返回错误响应，避免静默失败。
- 调试技巧：可在 verify 中间件或各路由开头添加 console.log("Route hit:", req.originalUrl) 快速定位实际触发路径。
通过重构路由声明顺序并强化参数校验，即可确保 /api/budget/search 正确触发，彻底解决“函数未执行、无日志、空响应”的问题。
