如何不使用try/catch处理Jest/Axios错误并获取详细失败信息？

通过Axios的响应拦截器，把后端返回的错误信息（比如验证失败字段、错误描述）直接整合到Error对象中，这样Jest捕获错误时就能输出完整信息，无需额外try/catch。

// src/utils/axiosInstance.ts
import axios from 'axios';

const apiClient = axios.create({
  baseURL: 'https://your-api-domain.com',
});

// 响应拦截器：增强错误信息
apiClient.interceptors.response.use(
  (response) => response,
  (error) => {
    if (error.response?.data) {
      // 重写错误消息，追加后端返回的详情
      error.message = [
        error.message,
        '后端错误详情:',
        JSON.stringify(error.response.data, null, 2)
      ].join('\n');
      // 给Error对象添加自定义属性，方便后续断言
      (error as any).details = error.response.data;
    }
    return Promise.reject(error);
  }
);

export default apiClient;

之后你的callApi方法基于这个实例封装，测试时如果请求失败，Jest会直接打印包含后端详情的错误信息，比如：

Request failed with status code 400
后端错误详情:
{
  "errors": {
    "email": "邮箱格式不正确",
    "password": "密码长度不能少于6位"
  }
}

编写一个专属的Jest匹配器，替代expect(req.status).toEqual(200)，让匹配器自动处理成功/失败场景，并在失败时输出完整错误信息。

步骤1：配置Jest全局匹配器 #

在你的Jest配置文件（比如jest.setup.ts）中添加：

// jest.setup.ts
expect.extend({
  async toHaveSuccessStatus(received, expectedStatus = 200) {
    try {
      const response = await received;
      const pass = response.status === expectedStatus;
      return {
        pass,
        message: () => pass
          ? `预期状态码不是${expectedStatus}`
          : `预期状态码${expectedStatus}，实际得到${response.status}`,
      };
    } catch (error) {
      const axiosError = error as { response?: { status: number; data: unknown } };
      if (axiosError.response) {
        return {
          pass: false,
          message: () => [
            `请求失败，状态码：${axiosError.response.status}`,
            `响应详情：${JSON.stringify(axiosError.response.data, null, 2)}`
          ].join('\n'),
        };
      }
      return {
        pass: false,
        message: () => `意外错误：${(error as Error).message}`,
      };
    }
  },
});

// TypeScript类型声明（可选）
declare global {
  namespace jest {
    interface Matchers<R> {
      toHaveSuccessStatus(expectedStatus?: number): Promise<R>;
    }
  }
}

步骤2：在测试中使用匹配器 #

test('提交合法参数返回200', async () => {
  await expect(callApi(validPayload)).toHaveSuccessStatus(200);
});

test('提交非法参数返回详细错误', async () => {
  await expect(callApi(invalidPayload)).toHaveSuccessStatus(200);
  // 失败时自动打印状态码+后端错误详情
});

如果需要针对特定错误场景做精准断言，可以直接用Jest的rejects匹配器，结合Axios错误对象的结构：

test('非法参数返回400及验证错误', async () => {
  await expect(callApi(invalidPayload)).rejects.toMatchObject({
    response: {
      status: 400,
      data: {
        errors: expect.objectContaining({
          email: expect.any(String),
        }),
      },
    },
  });
});

这种方式能精准验证错误的具体结构，同时Jest在断言失败时会输出实际的错误数据。

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