使用Superagent/Supertest/Jest测试时返回404而非预期400的问题

问题根源 #

测试时Blog.findById(invalidId)未抛出预期的CastError，而是直接返回null，导致代码进入else分支返回404状态码。这大概率是Mongoose版本差异或测试环境模型配置问题，使得无效ID的处理逻辑与生产环境不一致。

解决方案 #

1. 手动前置验证ID格式 #

在查询数据库前主动校验ObjectId格式，确保格式错误时抛出CastError，让错误处理器捕获并返回400：

const mongoose = require('mongoose');

blogsRouter.get('/:id', async (req, res, next) => {
  try {
    const { id } = req.params;

    // 手动验证ObjectId合法性
    if (!mongoose.Types.ObjectId.isValid(id)) {
      const castError = new Error(`Cast to ObjectId failed for value "${id}" at path "_id"`);
      castError.name = 'CastError';
      throw castError;
    }

    const blog = await Blog.findById(id);
    if (blog) {
      res.status(200).json(blog);
    } else {
      res.status(404).end();
    }
  } catch (error) {
    next(error);
  }
});

2. 确认测试环境的中间件配置 #

确保测试中使用的Express实例与生产环境一致，已正确挂载errorHandler中间件：

// 测试文件中初始化app的代码
app.use(blogsRouter);
app.use(errorHandler); // 必须确保这一行存在

验证修改 #

重新运行Jest测试，此时传入格式错误的ID会触发手动抛出的CastError，经错误处理器处理后返回400状态码，符合预期逻辑。

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