FeathersJS Before Hook抛错返回500错误及HTML响应，而非预期400

我之前也遇到过一模一样的问题！核心原因是你直接抛出的普通Error不会被框架自动识别为400错误，默认都会被当成500服务器内部错误处理，而且像Express这类框架的默认错误响应就是HTML格式的。下面给你两种靠谱的解决办法：

方法一：自定义带状态码的错误类 #

创建一个继承自Error的自定义错误类，给它加上statusCode属性，这样错误处理中间件就能识别并返回正确的状态码和JSON响应：

// 定义自定义400错误类
class BadRequestError extends Error {
  constructor(message) {
    super(message);
    this.statusCode = 400;
    this.name = 'BadRequestError'; // 可选，用于更精准的错误识别
  }
}

// 在你的Before Hook中使用
app.use((req, res, next) => {
  const { targetParam } = req.query;
  
  // 验证逻辑，比如检查参数是否存在或格式合法
  if (!targetParam || targetParam.length < 3) {
    throw new BadRequestError('查询参数targetParam格式不合法，长度至少为3');
  }
  
  next(); // 验证通过，继续执行后续逻辑
});

// 错误处理中间件（必须放在所有路由和中间件的最后！）
app.use((err, req, res, next) => {
  // 识别自定义的400错误
  if (err instanceof BadRequestError) {
    return res.status(err.statusCode).json({
      success: false,
      error: {
        type: err.name,
        message: err.message
      }
    });
  }
  
  // 其他未识别的错误默认返回500
  res.status(500).json({
    success: false,
    error: {
      type: 'InternalServerError',
      message: '服务器内部错误'
    }
  });
});

方法二：直接给错误对象添加状态码（无需自定义类） #

如果不想创建新的错误类，可以直接在抛出错误前给Error实例添加statusCode属性，然后通过next(err)传递错误：

// 在Before Hook中验证参数
app.use((req, res, next) => {
  const { targetParam } = req.query;
  
  if (!targetParam || !/^[A-Za-z0-9]+$/.test(targetParam)) {
    const err = new Error('查询参数targetParam只能包含字母和数字');
    err.statusCode = 400; // 手动添加状态码
    return next(err); // 传递错误给处理中间件，注意这里要return避免继续执行next()
  }
  
  next();
});

// 通用错误处理中间件
app.use((err, req, res, next) => {
  // 优先使用错误自带的状态码，默认500
  const statusCode = err.statusCode || 500;
  res.status(statusCode).json({
    success: false,
    message: err.message || '请求处理失败'
  });
});

关键注意事项 #

• 错误处理中间件的位置：必须放在所有路由、其他中间件的最后，否则框架不会用它来处理错误。
• 不要直接throw后不处理：在中间件里直接throw错误，部分框架可能无法正确捕获，最好用next(err)的方式传递错误。
• 避免默认HTML响应：框架默认的错误响应是HTML格式，所以必须自定义错误处理中间件来返回JSON格式的响应，符合API接口的预期。

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