REST API中GET随机接口与GET按ID接口的路由冲突解决

这是Express路由匹配顺序导致的问题——动态路由/:char_id会优先匹配所有/characters/xxx格式的请求，包括/random，所以把字符串"random"当成char_id传入，触发了类型转换错误。以下是三种实用解决方法：

1. 调整路由定义顺序（最简单直接） #

Express路由是从上到下依次匹配的，把静态的/random路由放到动态路由/:char_id前面，这样请求/characters/random时会先匹配到静态路由，不会走到动态路由里。修改后的代码：

// Get Random Character
router.get('/random', async (req, res, next) => {
    try {
        const characters = await Character.find();
        if (characters.length == 0) return res.status(404).json({ message: 'No characters found in the database. Something must have went wrong.' });
        else {
            const random = Math.floor(Math.random() * characters.length);
            res.status(200).json(characters[random]);
        };
    } catch (err) {
        res.status(500).json({ message: err.message });
    }
});

// Get Specific Character by ID
router.get('/:char_id', async (req, res, next) => {
    try {
        const character = await Character.find({ char_id: req.params.char_id });
        if (character.length == 0) return res.status(404).json({ message: 'No characters found with ID: ' + req.params.char_id });
        else { res.status(200).json(character) };
    } catch (err) {
        res.status(500).json({ message: err.message });
    }
});

2. 给动态路由添加正则约束 #

如果你的char_id是数字类型，可以给动态路由参数加上正则表达式，限制只有数字才会匹配这个路由。这样"random"字符串不会被匹配，会自动落到/random路由：

// 只匹配数字格式的char_id
router.get('/:char_id(\\d+)', async (req, res, next) => {
    try {
        const character = await Character.find({ char_id: req.params.char_id });
        if (character.length == 0) return res.status(404).json({ message: 'No characters found with ID: ' + req.params.char_id });
        else { res.status(200).json(character) };
    } catch (err) {
        res.status(500).json({ message: err.message });
    }
});

// Get Random Character
router.get('/random', async (req, res, next) => {
    // 原逻辑不变
});

3. 用中间件做参数校验 #

在动态路由的处理函数里先校验char_id的格式，如果不是合法的ID（比如不是数字），就调用next()让后续路由处理：

router.get('/:char_id', async (req, res, next) => {
    // 先判断char_id是否为有效数字
    const charId = Number(req.params.char_id);
    if (isNaN(charId)) {
        // 不是有效ID，交给下一个路由处理
        return next();
    }
    try {
        const character = await Character.find({ char_id: charId });
        if (character.length == 0) return res.status(404).json({ message: 'No characters found with ID: ' + charId });
        else { res.status(200).json(character) };
    } catch (err) {
        res.status(500).json({ message: err.message });
    }
});

// Get Random Character
router.get('/random', async (req, res, next) => {
    // 原逻辑不变
});

各方法适用场景 #

• 调整顺序：适合小型项目或路由结构简单的场景，实现成本最低。
• 正则约束：适合参数格式明确的场景，能从路由层面直接拦截非法请求。
• 中间件校验：适合需要复杂校验逻辑的场景，灵活性更高。

内容的提问来源于stack exchange，提问作者Renato