Undici项目中自定义Agent导致Mock拦截器body类型异常问题分析

问题现象

在使用Undici库进行HTTP请求模拟测试时，开发者发现当为MockAgent配置自定义Agent后，拦截器中的body参数变成了AsyncGenerator类型，而不是预期的请求体内容。具体表现为：

1. 设置自定义Agent后，拦截器回调接收到的body参数是Object [AsyncGenerator] {}
2. 预期应该直接获取到原始请求体内容（如字符串"test"）
3. 移除fetch调用的dispatcher参数后，行为恢复正常

技术背景

Undici是Node.js官方维护的高性能HTTP/1.1客户端，提供了MockAgent功能用于测试场景。MockAgent可以拦截HTTP请求并返回预设的响应，通常用于单元测试中模拟外部服务。

问题根源

经过分析，这个问题源于Undici的请求分发机制：

1. 当fetch调用显式指定dispatcher参数时，会优先使用该dispatcher处理请求
2. 如果使用自定义Agent作为dispatcher，请求会绕过MockAgent的拦截逻辑
3. 导致MockAgent的拦截器无法正确解析请求体，只能获取到原始的AsyncGenerator对象

解决方案

开发者有两种方式解决这个问题：

1. 推荐方案：不指定dispatcher参数，让请求自动使用全局的MockAgent

await fetch("http://localhost/test", {
    method: "POST",
    body: "test"
});

2. 替代方案：如果必须使用自定义Agent，可以将其标记为mock模式

const agent = new Agent();
agent.isMockActive = true;

最佳实践

在使用Undici进行测试时，建议：

1. 优先使用全局MockAgent配置，避免dispatcher参数冲突
2. 如果测试代码必须使用特定Agent，确保正确设置mock标志
3. 对于复杂的测试场景，考虑分层设计测试用例，隔离真实请求和模拟请求

总结

这个问题揭示了Undici中请求分发优先级和Mock机制交互的一个细节。理解Undici内部的分发机制有助于开发者编写更可靠的测试代码。在测试环境中，保持Mock配置的纯净性往往能避免这类边界情况的发生。