Vitest 2.1.5版本后Undici MockAgent拦截失效问题分析

问题背景

在Vitest测试框架升级到2.1.5版本后，开发者发现原本使用Undici库的MockAgent功能无法再拦截fetch请求。这个问题源于Vitest在该版本中引入了一个重要变更：将默认的fetch实现从Undici切换到了happy-dom提供的实现。

技术细节解析

Undici是Node.js官方维护的一个高性能HTTP客户端库，它提供了MockAgent功能，允许开发者拦截和模拟HTTP请求。这种功能在单元测试中非常有用，可以避免真实的网络调用。

在Vitest 2.1.5版本之前，当开发者设置全局Dispatcher为MockAgent实例时，所有通过fetch发出的请求都会被MockAgent拦截。然而，版本更新后，由于Vitest内部改用了happy-dom的fetch实现，导致Undici的拦截机制失效。

解决方案

对于需要继续使用Undici MockAgent功能的开发者，可以采用以下解决方案：

1. 显式覆盖全局fetch：在测试文件中，手动将全局fetch重新设置为Undici的实现。

import { fetch } from "undici";
globalThis.fetch = fetch;

2. 配置Vitest环境：考虑在Vitest配置中指定使用Node环境而非默认的happy-dom环境。

3. 等待happy-dom支持：如果happy-dom未来版本支持类似的Mock功能，可以考虑直接使用其提供的Mock机制。

最佳实践建议

对于测试环境中的HTTP请求模拟，开发者应该：

1. 明确测试框架的默认行为，了解其底层实现机制
2. 在项目升级时，仔细阅读变更日志，特别是关于全局API的改动
3. 考虑将HTTP客户端抽象为服务层，便于测试时替换实现
4. 对于关键的网络请求测试，考虑添加断言验证Mock是否生效

总结

这个问题展示了测试工具链中依赖关系变化可能带来的影响。作为开发者，理解工具底层实现原理和版本变更内容至关重要。通过适当的配置和明确的依赖管理，可以确保测试环境的稳定性和可靠性。