REST API路由匹配异常问题：请求搜索接口却返回按ID查询的响应

云上老周

2026-5-1

问题原因与解决方案

这个问题我太熟悉了，完全是Express路由的匹配顺序在搞鬼！

核心原因

Express的路由匹配是按照你定义路由的先后顺序进行的。你现在的代码里，/brands/:id这个带动态参数的路由写在了/brands/search前面，当你发送GET /brands/search?searchQuery=xxx的请求时，Express会把路径里的search当成:id参数的取值，直接进入按ID查询的处理逻辑——自然找不到对应ID的Brand，就返回了Brand is not found!的错误。

解决办法

只需要把具体的固定路径路由（比如/brands/search）移到带动态参数的路由（比如/brands/:id）前面，让Express优先匹配明确的路径：

修改后的brands.js代码如下：

const express = require('express');
const Brand = require('../models/catalog/brands');
const Admin = require('../models/users/admin');
const Manager = require('../models/users/manager');
const StoreKeeper = require('../models/users/storeKeeper');
const auth = require('../middleware/auth');
const router = express.Router();

// 先定义明确的search路由
router.get('/brands/search', async (req, res) => {
 const { searchQuery } = req.query;
 try {
 const title = new RegExp(searchQuery, 'i');
 const items = await Brand.find({ name: title });
 res.json({ items });
 } catch (err) {
 res.status(404).json({ error: 'Wrong request' });
 }
});

// 再定义带动态参数的ID路由
router.get('/brands/:id', async (req, res) => {
 const { id } = req.params;
 try {
 const item = await Brand.findById(id);
 res.json({ item });
 } catch (err) {
 res.status(404).json({ error: 'Brand is not found!' });
 }
});

module.exports = router;