解决axios在jsdom环境中自签名证书验证问题

在Node.js环境中使用axios进行HTTPS请求时，开发者经常会遇到自签名证书验证的问题。本文将深入分析axios在不同测试环境下的行为差异，并提供解决方案。

问题背景

当开发者在Vitest测试框架中切换测试环境时，可能会发现一个有趣的现象：使用自签名证书的服务端请求在Node环境下能正常工作，但在jsdom环境下却会抛出"self-signed certificate"错误。

根本原因分析

这种现象源于axios在不同环境下使用不同的适配器：

1. Node环境：默认使用基于Node.js原生http/https模块的适配器
2. jsdom环境：默认使用XMLHttpRequest(XHR)适配器

关键区别在于：

• Node的https模块提供了rejectUnauthorized选项来跳过证书验证
• XHR适配器没有暴露这个配置选项，因此会严格执行证书验证

解决方案

要解决这个问题，我们可以强制axios在jsdom环境中也使用Node的http适配器：

const https = require('https');
const axios = require('axios');

const instance = axios.create({
  baseURL: 'https://localhost:3000',
  httpsAgent: new https.Agent({
    rejectUnauthorized: false  // 忽略证书验证
  }),
  adapter: 'http'  // 显式指定使用Node的http适配器
});

深入理解

1. 适配器机制：axios的设计允许在不同环境中使用最适合的底层实现
2. 安全考量：生产环境中不建议禁用证书验证，仅限开发和测试使用
3. 环境差异：测试时需要考虑不同环境下的行为差异

最佳实践

1. 为测试环境配置专门的证书处理逻辑
2. 使用环境变量区分不同环境的配置
3. 考虑使用证书颁发机构(CA)签发的证书替代自签名证书

通过理解axios的底层机制和环境差异，开发者可以更灵活地处理各种网络请求场景，特别是在测试环境中遇到的特殊问题。