如何在Jest测试中执行真实API调用？superagent/axios调用失败

当然可以在Jest测试里发起真实的API请求！你遇到失败的情况大概率是配置或者环境的小问题，我来帮你梳理下常见的原因和解决办法：

• 检查Jest超时设置
  Jest默认的测试超时时间是5000ms（5秒），如果你的API响应较慢，很容易触发超时失败。你可以给单个测试用例单独设置超时，或者在全局配置里调整：

  // 给单个测试用例设置10秒超时
  test('获取API数据', async () => {
    const response = await axios.get('https://your-api-target.com/data');
    expect(response.status).toBe(200);
  }, 10000);
  
  // 全局配置（jest.config.js）
  module.exports = {
    testTimeout: 10000, // 全局设置10秒超时
  };
  

• 确保异步测试的正确写法
  很多时候请求失败是因为Jest没等异步请求完成就结束了测试。一定要用async/await或者返回Promise来标记异步测试：
  ❌ 错误写法（会直接失败）：

  test('错误的异步测试', () => {
    axios.get('https://your-api-target.com/data');
  });
  

  ✅ 正确写法：

  test('正确的异步测试', async () => {
    const res = await axios.get('https://your-api-target.com/data');
    expect(res.data).toHaveProperty('key');
  });
  

• 验证网络和API可用性
  先确认你的测试环境能正常访问目标API——比如有没有代理限制、防火墙拦截，或者API本身是否处于可用状态。可以先在终端用curl测试下：

  curl https://your-api-target.com/data
  

  如果这个命令都拿不到响应，那问题就不在Jest上了。

• 处理HTTPS证书问题
  如果你的API用的是自签名HTTPS证书，Node.js默认会拒绝请求，导致失败。可以在测试里临时禁用证书验证：

  • 针对axios：

    const axios = require('axios').default;
    // 禁用证书验证
    axios.defaults.httpsAgent = new (require('https').Agent)({ rejectUnauthorized: false });
    

  • 针对superagent：

    const superagent = require('superagent');
    superagent.get('https://your-api-target.com/data')
      .agent(new (require('https').Agent)({ rejectUnauthorized: false }))
      .then(res => { /* 处理响应逻辑 */ });
    

• 捕获详细报错信息
  你提到控制台有报错，建议在测试里捕获错误并打印详细信息，方便精准定位：

  test('捕获请求错误详情', async () => {
    try {
      const res = await axios.get('https://your-api-target.com/data');
      expect(res.status).toBe(200);
    } catch (err) {
      console.error('请求失败详情:', err.response?.data || err.message);
      throw err; // 保持测试失败，方便后续排查
    }
  });
  

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