Node.js Express RestFul API：未找到车牌时404状态及空响应问题

我之前也碰到过类似的情况，咱们一步步来排查和修复这个问题：

1. 定位问题根源 #

当查询未注册车牌时出现空响应，本质是你的代码没有对数据库查询结果为空的场景发送明确的HTTP响应，导致请求一直处于挂起状态，最终返回空内容。

2. 检查并修复路由处理逻辑 #

假设你使用的是mysql或mysql2库，先看看你的代码是不是类似下面这种错误写法：

app.get('/_api_v1/car/:plateNumber', (req, res) => {
  const plateNumber = req.params.plateNumber;
  db.query('SELECT * FROM cars WHERE plate = ?', [plateNumber], (err, results) => {
    if (err) {
      return res.status(500).json({ error: err.message });
    }
    // 只处理了有查询结果的情况，空结果时完全没发送响应
    if (results.length > 0) {
      res.json(results[0]);
    }
  });
});

只需要在查询结果为空时，明确返回404状态和错误信息即可：

app.get('/_api_v1/car/:plateNumber', (req, res) => {
  const plateNumber = req.params.plateNumber;
  db.query('SELECT * FROM cars WHERE plate = ?', [plateNumber], (err, results) => {
    if (err) {
      return res.status(500).json({ error: '数据库查询失败' });
    }
    if (results.length === 0) {
      // 明确返回404状态和对应提示
      return res.status(404).json({ error: '404 Not Found' });
    }
    res.json(results[0]);
  });
});

3. 额外注意事项（Promise风格操作） #

如果你用的是mysql2/promise这类Promise风格的数据库库，要确保在async/await逻辑里同样处理空结果，并且不要遗漏错误捕获：

app.get('/_api_v1/car/:plateNumber', async (req, res) => {
  try {
    const plateNumber = req.params.plateNumber;
    const [results] = await db.query('SELECT * FROM cars WHERE plate = ?', [plateNumber]);
    if (results.length === 0) {
      return res.status(404).json({ error: '404 Not Found' });
    }
    res.json(results[0]);
  } catch (err) {
    res.status(500).json({ error: '数据库查询失败' });
  }
});

核心思路就是：无论数据库查询结果如何，都要给客户端发送一个明确的HTTP响应，不能让请求处于未完成的状态，这样就不会出现空响应的问题了。

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