Wretch库中FormData请求体丢失问题解析

问题背景

在JavaScript的HTTP客户端库Wretch中，开发者发现了一个关于FormData请求体处理的bug。当使用PUT、POST或PATCH方法时，如果直接将FormData对象作为这些方法的第一个参数传递，请求体会意外丢失。

问题现象

具体表现为：

1. 当使用FormData作为请求体时，Content-Type头被错误地设置为application/json
2. 服务器端接收到的请求体中没有任何数据
3. 这与原生fetch API的行为不一致，因为fetch原生支持FormData

技术分析

问题的根源在于Wretch库的请求体处理逻辑。在核心代码中，存在一个自动JSON序列化的条件判断，这个判断没有正确处理FormData类型的特殊情况。

当前的条件判断逻辑是：如果请求体是对象类型且没有设置Content-Type头或Content-Type看起来是JSON类型，则自动进行JSON序列化。这个逻辑错误地将FormData对象也包含在内，因为FormData确实也是对象类型。

解决方案

正确的处理方式应该是：

1. 首先检查请求体是否是FormData实例
2. 如果是FormData，则跳过JSON序列化
3. 如果不是FormData，再执行原有的判断逻辑

修正后的条件判断应该类似于：

const jsonify = !(body instanceof FormData) && 
                typeof body === "object" && 
                (!base._options.headers || 
                 !contentType || 
                 isLikelyJsonMime(contentType))

最佳实践建议

1. 当使用FormData时，最好显式设置Content-Type为'multipart/form-data'，虽然现代浏览器会自动设置
2. 对于复杂的表单数据，考虑使用专门的表单处理库
3. 在升级Wretch版本时，注意测试FormData相关功能

总结

这个问题展示了类型检查在HTTP客户端库中的重要性。正确处理各种请求体类型是HTTP客户端的基本要求。Wretch作为fetch的封装库，应当保持与原生fetch一致的行为，特别是在FormData这种常见用例上。开发者在使用时应当注意这类边界情况，特别是在处理文件上传等需要使用FormData的场景时。