Express.js中无ID参数的GET请求未返回预期错误

问题描述 #

调用GET请求 localhost:3000/api/users/id/（未携带ID数值）时，期望返回结构化JSON错误：

{
    "errors": [
        {
            "type": "field",
            "msg": "Must not be empty",
            "path": "filter",
            "location": "body"
        }
    ]
}

但实际返回包含 <pre>Cannot GET /api/users/id/</pre> 的HTML错误页面。

核心原因 #

1. 路由不匹配：当前路由定义为 /api/users/id/:id，其中 :id 是必填URL参数。当请求 /api/users/id/ 时，Express找不到匹配的路由规则，直接返回默认的404 HTML响应。
2. 中间件顺序错误：findUserIndex 中间件在 checkSchema 之前执行，但如果路由不匹配，校验逻辑根本不会触发。
3. 校验目标与期望不符：当前Schema校验的是URL参数 id，但期望错误中指定的是 filter（且位置为 body），两者不匹配。
4. 错误响应格式不一致：部分中间件使用 sendStatus 返回状态码，会触发Express默认的HTML响应体，而非JSON格式。

修复步骤 #

1. 处理无参数的路由请求 #

添加单独的路由规则处理 /api/users/id/，确保未携带ID时返回指定的JSON错误：

// 处理未携带ID的请求，返回期望的JSON错误
app.get("/api/users/id/", (req, res) => {
  return res.status(400).json({
    errors: [
      {
        "type": "field",
        "msg": "Must not be empty",
        "path": "filter",
        "location": "body"
      }
    ]
  });
});

2. 调整中间件顺序 #

将参数校验（checkSchema）放在 findUserIndex 之前，确保先完成参数合法性校验，再执行用户查找逻辑：

// 带ID的路由：先校验参数，再查找用户
app.get("/api/users/id/:id", checkSchema(getUserValidationIdSchema), findUserIndex, (req, res) => {
    const result = validationResult(req);
    if (!result.isEmpty()) return res.status(400).json({errors: result.array()});
    res.json(users[req.userIndex]);
});

3. 修正错误响应格式 #

将 findUserIndex 中的 sendStatus 改为返回JSON格式错误，统一响应格式：

const findUserIndex = (req, res, next) => {
    const {params: {id}} = req;
    const parsedId = parseInt(id);
    if (isNaN(parsedId)) {
        return res.status(400).json({
            errors: [
                {
                    type: "field",
                    msg: "ID must be a valid number",
                    path: "id",
                    location: "params"
                }
            ]
        });
    }
    const userIndex = users.findIndex((user) => user.id === parsedId);
    if (userIndex === -1) {
        return res.status(404).json({
            errors: [
                {
                    type: "field",
                    msg: "User not found",
                    path: "id",
                    location: "params"
                }
            ]
        });
    }
    req.userIndex = userIndex;
    req.parsedId = parsedId;
    next();
};

4. 对齐校验规则与期望（可选） #

如果实际需要校验的是 body 中的 filter 参数（而非URL参数 id），需调整Schema并确保请求携带Body（注意GET请求通常不携带Body，建议改为POST或使用Query参数）：

export const getUserValidationIdSchema = {
    filter: {
        notEmpty: {errorMessage: "Must not be empty"},
        in: ['body'] // 指定校验位置为body
    }
};

完整代码示例 #

// 处理无ID请求
app.get("/api/users/id/", (req, res) => {
  return res.status(400).json({
    errors: [
      {
        "type": "field",
        "msg": "Must not be empty",
        "path": "filter",
        "location": "body"
      }
    ]
  });
});

// 带ID的路由
app.get("/api/users/id/:id", checkSchema(getUserValidationIdSchema), findUserIndex, (req, res) => {
    const result = validationResult(req);
    if (!result.isEmpty()) return res.status(400).json({errors: result.array()});
    res.json(users[req.userIndex]);
});

// findUserIndex中间件
const findUserIndex = (req, res, next) => {
    const {params: {id}} = req;
    const parsedId = parseInt(id);
    if (isNaN(parsedId)) {
        return res.status(400).json({
            errors: [
                {
                    type: "field",
                    msg: "ID must be a valid number",
                    path: "id",
                    location: "params"
                }
            ]
        });
    }
    const userIndex = users.findIndex((user) => user.id === parsedId);
    if (userIndex === -1) {
        return res.status(404).json({
            errors: [
                {
                    type: "field",
                    msg: "User not found",
                    path: "id",
                    location: "params"
                }
            ]
        });
    }
    req.userIndex = userIndex;
    req.parsedId = parsedId;
    next();
};

// 校验Schema（如果需要校验filter则调整）
export const getUserValidationIdSchema = {
    id: {
        notEmpty: {errorMessage: "Must not be empty"},
    }
};

内容的提问来源于stack exchange，提问作者Gustavo F. Marcial