Express 中路由匹配遵循定义顺序优先、路径模式贪婪匹配原则；/api/budget/:year 会错误捕获 /api/budget/search 请求，使后续同前缀的精确路由（如 /api/budget/search）完全不被执行。
express 中路由顺序冲突导致 `/api/budget/search` 未执行
在 Express 应用中，路由匹配并非仅依赖“字符串完全相等”，而是按注册顺序自上而下逐条尝试匹配，且使用路径参数（如 :year）的动态路由具有较高匹配优先级——只要 URL 路径满足其模式，就会立即进入该处理函数，后续更具体的路由将被跳过。
你的路由列表中存在关键冲突：
app.get("/api/budget/:year", verify, async (req, res) => { /* ... */ });
// ↓ 这行之后才定义：
app.get("/api/budget/search", verify, async (req, res) => { /* ... */ });当客户端请求 /api/budget/search 时，Express 将其视为：
- :year = "search"（因为 search 是一个合法的路径段，符合 :year 的通配逻辑）
- 于是直接匹配到 /api/budget/:year 路由，根本不会继续检查后面的 /api/budget/search
这就是为什么：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 控制台无 console.log(req.query.q) 输出；
- 数据库查询未执行；
- 却仍返回 200 OK（取决于 /api/budget/:year 处理函数是否调用了 res.send() 或 res.json()）；
- 而 /api/users/search 工作正常——因其前缀 users 不与任何已有动态路由冲突。
✅ 解决方案：调整路由声明顺序，将更具体的静态路由置于更通用的动态路由之前。
// ✅ 正确顺序：先定义精确路径，再定义参数化路径
app.get("/api/budget/search", verify, async (req, res) => {
console.log("Search route hit:", req.query.q);
try {
const users = await db
.collection("users")
.find({ username: { $regex: req.query.q, $options: "i" } })
.toArray();
// 安全移除敏感字段（建议用 projection 替代 forEach 删除）
const sanitized = users.map(({ password, ...rest }) => rest);
res.json(sanitized);
} catch (err) {
console.error("Search error:", err);
res.status(500).json({ error: "Search failed" });
}
});
// ❌ 以下动态路由必须放在所有 /api/budget/* 精确路由之后
app.get("/api/budget/whoami", verify, (req, res) => { /* ... */ });
app.get("/api/budget", verify, async (req, res) => { /* ... */ });
app.get("/api/budget/:year", verify, async (req, res) => { /* ... */ });
app.get("/api/budget/:year/:month", verify, async (req, res) => { /* ... */ });
app.get("/api/budget/:year/:month/:id", verify, async (req, res) => { /* ... */ });
// 其他 POST/PUT/DELETE 同理，保持静态 > 动态顺序⚠️ 额外建议：
- 在开发阶段添加「兜底 404 路由」，定位未匹配问题：
app.use((req, res) => { console.warn(`⚠️ Unmatched route: ${req.method} ${req.originalUrl}`); res.status(404).json({ error: "Not Found" }); }); - MongoDB 查询增强安全性：为 $regex 添加 i 标志实现大小写不敏感，并避免空查询（如 !req.query.q?.trim() 时提前返回空数组）；
- verify 中间件缺少 next() 调用会导致挂起——当前代码在未认证时仅设状态码，但未结束响应，应改为：
function verify(req, res, next) { if (req.session.user) return next(); res.status(403).json({ error: "Unauthorized" }); }
通过严格遵循「具体优先、顺序敏感」的路由设计原则，即可彻底规避此类静默失效问题。
