Node.js Express中如何将路由捕获的错误转发至错误处理中间件

Got it, let's break this down. You already have your error-handling middleware set up and working when you throw errors directly—great! The key here is understanding how Express routes errors to that middleware, even in async/Promise scenarios.

Core Concept #

Express uses the next(err) function to trigger its error-handling pipeline. When you pass an error object to next(), Express skips all regular route handlers/middleware and jumps straight to your error-handling middleware (the one with the (err, req, res, next) signature).

Fixing Promise Catch Blocks #

Instead of sending a direct response in your catch block, just pass the caught error to next(). Here's how to adjust your code:

Before (Direct Response)

app.get('/your-route', (req, res) => {
  yourAsyncPromiseFunction()
    .then(data => res.json(data))
    .catch(err => {
      // Old approach: handling error directly here
      res.status(500).send('Something went wrong: ' + err.message);
    });
});

After (Forward to Error Middleware)

app.get('/your-route', (req, res, next) => {
  yourAsyncPromiseFunction()
    .then(data => res.json(data))
    .catch(err => {
      // Pass the error to next() to trigger your error-handling middleware
      next(err);
    });
});

Important Note: Make sure your route handler includes the next parameter—you need it to call the error pipeline.

Bonus: Async/Await Version #

If you're using async/await (which cleans up Promise code nicely), the approach is similar. Just catch the error and pass it to next():

app.get('/your-route', async (req, res, next) => {
  try {
    const data = await yourAsyncPromiseFunction();
    res.json(data);
  } catch (err) {
    next(err); // Forward error to middleware
  }
});

Verify Your Error-Handling Middleware #

Just to double-check, ensure your middleware has all four parameters (Express requires this to recognize it as an error-handler):

// Your existing error-handling middleware
app.use((err, req, res, next) => {
  console.error('Error details:', err);
  // Customize the response based on the error
  const statusCode = err.statusCode || 500;
  res.status(statusCode).json({
    error: {
      message: err.message || 'Internal Server Error',
      code: err.code || 'SERVER_ERROR'
    }
  });
});

Why This Works #

When you throw an error synchronously in a route handler, Express automatically catches it and passes it to your error middleware. But for async code (like Promises), Express can't catch the error unless you explicitly pass it to next(). That's why your original catch block was handling the error directly—you just needed to redirect it to the pipeline instead.

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