Undici项目中FormData在重定向请求时的异常分析

问题背景

在Node.js生态中，Undici作为一款高性能的HTTP客户端库，被广泛应用于现代JavaScript应用中。近期发现了一个与FormData和HTTP重定向相关的异常行为：当使用FormData作为请求体发送POST请求时，如果服务器返回重定向响应，Undici会抛出类型错误。

问题现象

开发者在使用Undici发送包含FormData的POST请求时，遇到如下错误：

TypeError [ERR_INVALID_ARG_TYPE]: The "string" argument must be of type string or an instance of Buffer or ArrayBuffer. Received an instance of Array

这个错误发生在请求被重定向时，具体表现为：

1. 创建FormData实例并添加字段
2. 使用该FormData作为请求体发送POST请求
3. 目标URL触发HTTP重定向（如从http跳转到https）
4. 重定向过程中抛出上述类型错误

技术分析

根本原因

该问题的核心在于重定向处理逻辑中对FormData类型的处理不完善。当HTTP客户端遇到重定向响应时，通常需要决定如何处理原始请求的请求体：

1. 对于301/302等临时重定向，规范建议保留原始请求方法和请求体
2. 对于303等特殊重定向，可能需要将POST转为GET并丢弃请求体

Undici在处理重定向时，未能正确识别FormData类型，导致在尝试计算请求体大小时传入了不兼容的数据类型。

影响范围

该问题影响以下场景：

• 使用FormData作为请求体
• 请求触发服务器重定向
• 同时使用HTTP/1.1或HTTP/2协议

解决方案

临时解决方案

对于急需解决问题的开发者，可以考虑以下临时方案：

1. 手动处理重定向逻辑，避免依赖Undici的自动重定向
2. 将FormData转换为Buffer后再发送请求
3. 升级到Undici 7.0 alpha版本（但需注意该版本存在其他行为变更）

长期解决方案

Undici团队已经意识到这个问题，并在7.0版本中进行了修复。修复方案主要包括：

1. 完善FormData类型的识别和处理
2. 确保重定向过程中正确保持请求体
3. 统一HTTP/1.1和HTTP/2协议下的处理逻辑

最佳实践建议

为避免类似问题，建议开发者在处理包含请求体的重定向请求时：

1. 明确了解各种重定向状态码的语义差异
2. 对于重要请求，考虑手动处理重定向逻辑
3. 在测试阶段覆盖重定向场景
4. 关注Undici的版本更新，及时升级到稳定版本

总结

FormData与HTTP重定向的结合使用是Web开发中的常见场景，Undici作为底层HTTP客户端，正确处理这类场景至关重要。开发者应理解其中的技术细节，在遇到问题时能够快速定位并找到解决方案。随着Undici 7.0的正式发布，这一问题将得到彻底解决，为开发者提供更稳定可靠的使用体验。