MSW项目中FormData请求导致Jest测试挂起问题解析

问题现象

在使用MSW（Mock Service Worker）进行前端测试时，开发者发现当测试用例中包含使用FormData作为请求体的HTTP请求时，Jest测试框架会出现无法正常退出的情况。具体表现为测试运行结束后进程挂起，并提示存在未关闭的异步操作。

技术背景

FormData是一种常用于前端表单数据提交的接口，特别是在文件上传场景中。在GraphQL生态中，FormData还被用于实现GraphQL文件上传规范，即通过multipart/form-data格式传输GraphQL请求和文件数据。

问题复现

通过简化测试用例可以清晰地复现该问题：

1. 创建一个包含字段的FormData对象
2. 使用该FormData作为请求体构造Request对象
3. 在MSW的请求处理中访问该请求

测试运行后，Jest进程无法正常退出，提示存在未关闭的异步操作。值得注意的是，空的FormData不会引发此问题，只有当FormData包含实际字段时才会出现。

根本原因分析

经过深入调查发现，这实际上是Node.js核心的一个问题。问题出在Request对象的克隆操作上。当尝试克隆一个包含非空FormData体的Request对象时，Node.js进程会挂起。这个行为在Node.js v18.19.0、v20.11.0和v21.7.1等多个版本中均可复现。

技术细节

在底层实现上，Request克隆操作涉及到对请求体的流式处理。当请求体为FormData时，Node.js的底层实现（特别是undici模块）在处理这种特殊类型的流时存在缺陷，导致流无法正确关闭，进而使得整个进程无法退出。

解决方案建议

目前建议开发者采取以下临时解决方案：

1. 在测试中避免直接使用FormData作为请求体
2. 可以考虑使用JSON格式替代FormData进行测试
3. 关注Node.js官方对该问题的修复进展

总结

这个问题虽然在使用MSW进行测试时被发现，但其本质是Node.js核心的功能缺陷。作为开发者，理解这类问题的底层原因有助于更好地设计测试策略和规避方案。同时，这也提醒我们在使用较新的Web API时需要关注其在不同环境下的兼容性和稳定性表现。