Node.js接口如何在Postman响应中返回错误信息而非仅打印到控制台

问题场景 #

使用Node.js进行接口开发时，接口运行产生的错误仅会输出到服务端控制台窗口，无法直接在Postman的接口响应结果中展示。
当前实现代码如下：

try {
    const { username, email, password } = req.body;

    if (!username || !email || !password) {
      throw {
        status: 400,
        message: "All parameters are required"
      };
    }
    const result = await authController.newUser(username, email, password);
    console.log(result);
    res.status(200).json({
      status: 200,
      data: result.result.data,
      message: "User created successfully"
    });
  } catch (error) {
    console.log(error);
    next(error);
  }
});

当前错误仅在服务端控制台输出的效果参考：

问题原因 #

现有代码的catch块仅将错误打印到控制台、通过next(error)向后传递错误，但没有主动向请求方（Postman）写入错误响应；如果项目未配置全局错误处理中间件，错误不会被序列化返回给客户端，Postman只能拿到请求超时、默认错误页之类的结果，看不到具体错误信息。

实现方法 #

方案1：单接口直接返回错误（快速生效） #

直接修改当前接口的catch块逻辑，捕获到错误后直接返回对应状态码的JSON响应：

try {
    const { username, email, password } = req.body;

    if (!username || !email || !password) {
      throw {
        status: 400,
        message: "All parameters are required"
      };
    }
    const result = await authController.newUser(username, email, password);
    console.log(result);
    res.status(200).json({
      status: 200,
      data: result.result.data,
      message: "User created successfully"
    });
  } catch (error) {
    console.log(error);
    // 取错误自带的状态码，没有就默认返回500服务端错误
    const errStatus = error.status || 500;
    res.status(errStatus).json({
      status: errStatus,
      message: error.message || "Internal Server Error"
    });
  }
});

方案2：全局错误中间件统一处理（推荐多接口项目使用） #

在项目所有路由配置的末尾添加Express全局错误处理中间件，所有接口抛出的错误都会经过这个中间件统一返回，不需要每个接口单独写错误返回逻辑：

// 注意：全局错误中间件必须包含err, req, res, next四个参数，否则不会被识别为错误处理中间件
app.use((err, req, res, next) => {
  console.log(err);
  const errStatus = err.status || 500;
  res.status(errStatus).json({
    status: errStatus,
    message: err.message || "Internal Server Error",
    // 仅开发环境返回错误堆栈方便排查，生产环境注释掉该字段避免泄露服务端信息
    stack: process.env.NODE_ENV === "development" ? err.stack : undefined
  });
});

配置完成后，原有代码不需要修改，next(error)传递的错误会自动被该中间件处理，返回结构化错误信息到Postman。

注意：生产环境请关闭错误堆栈返回，避免暴露服务端内部路径、依赖版本等敏感信息。

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