API请求返回错误与服务器输出不符，如何自定义Express错误响应？

为什么客户端收到的错误和服务器不一致？ #

1. Express默认错误处理的自动简化：当你在Express异步路由里直接返回Error对象（或未正确传递错误），Express的默认错误处理器会把错误映射成对应HTTP状态码的极简响应。比如AuthenticationError会被自动识别为401状态，此时只会返回“Request failed with status code 401”这类通用提示，不会把你捕获的Binance详细错误信息传给客户端。
2. 错误传递方式不对：你的服务器代码里只是return error，但在Express的异步路由中，这种方式不会让框架处理错误细节，只会触发默认的状态码响应逻辑。

怎么返回自定义错误信息？ #

有两种常用方式，根据场景选择：

方式1：在catch块直接构造响应（适合单路由定制） #

修改服务器端的路由代码，手动组装包含Binance错误细节的JSON响应返回：

// Server.js /api/v1/exchanges/balance
app.get('/api/v1/exchanges/balance', async (req, res) => {
  const { uid } = req.params;
  const apikey = 'wrongkey';
  const apisec = 'wrongsec';
  try {
    const balance = await exchange.client.fetchBalance();
    res.json({ success: true, data: balance });
  } catch (error) {
    console.log(error);
    // 解析Binance返回的错误内容
    let binanceError = { code: -2015, msg: 'API认证失败' };
    if (error.message.includes('binance')) {
      binanceError = JSON.parse(error.message.split('binance ')[1]);
    }
    // 返回自定义错误响应
    res.status(401).json({
      success: false,
      error: binanceError,
      source: 'binance'
    });
  }
});

方式2：全局错误处理中间件（推荐，统一管理所有错误） #

先在路由里把错误传递给next()，再通过全局中间件统一格式化响应：

// 第一步：路由中正确传递错误
app.get('/api/v1/exchanges/balance', async (req, res, next) => {
  const { uid } = req.params;
  const apikey = 'wrongkey';
  const apisec = 'wrongsec';
  try {
    const balance = await exchange.client.fetchBalance();
    res.json({ success: true, data: balance });
  } catch (error) {
    console.log(error);
    // 把错误交给全局错误中间件处理
    next(error);
  }
});

// 第二步：全局错误处理中间件（必须放在所有路由之后）
app.use((err, req, res, next) => {
  // 针对性处理Binance认证错误
  if (err.name === 'AuthenticationError' && err.message.includes('binance')) {
    const binanceError = JSON.parse(err.message.split('binance ')[1]);
    return res.status(401).json({
      success: false,
      error_code: binanceError.code,
      error_msg: binanceError.msg,
      detail: 'Binance API密钥、IP或权限验证失败'
    });
  }

  // 处理其他所有错误
  const statusCode = err.statusCode || 500;
  res.status(statusCode).json({
    success: false,
    error_msg: err.message || '服务器内部错误',
    error_code: err.code || statusCode
  });
});

这样客户端就能收到包含Binance详细错误信息的响应，替代Express自动生成的极简提示。

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