Violentmonkey中GM_xmlhttpRequest处理FormData数组的缺陷分析

问题背景

在Web开发中，FormData对象常用于构造表单数据并通过XMLHttpRequest发送到服务器。当需要传递数组数据时，开发者通常会使用arrayName[]的命名约定，这在PHP等服务器端语言中可以自动转换为数组结构。

问题现象

Violentmonkey扩展提供的GM_xmlhttpRequest API在处理包含同名键的FormData对象时存在缺陷。当开发者使用标准XMLHttpRequest发送包含多个同名键(如array_data[])的FormData时，所有值都会被正确发送；而使用GM_xmlhttpRequest时，只有最后一个值会被保留，其他同名键的值会被丢弃。

技术细节分析

正常行为示例

标准XMLHttpRequest发送的请求体示例：

--------------------------边界字符串
Content-Disposition: form-data; name="name"
john
--------------------------边界字符串
Content-Disposition: form-data; name="array_data[]"
data1
--------------------------边界字符串
Content-Disposition: form-data; name="array_data[]"
data2
--------------------------边界字符串
Content-Disposition: form-data; name="array_data[]"
data3
--------------------------边界字符串--

Violentmonkey的问题行为

使用GM_xmlhttpRequest时，生成的请求体错误地只包含最后一个值：

--------------------------边界字符串
Content-Disposition: form-data; name="name"
john
--------------------------边界字符串
Content-Disposition: form-data; name="array_data[]"
data3
--------------------------边界字符串--

影响范围

这个缺陷主要影响以下场景：

1. 需要向PHP后端发送数组数据的用户脚本
2. 依赖同名表单字段传递多个值的API接口
3. 需要保持与标准XMLHttpRequest行为一致的脚本

解决方案

该问题已被Violentmonkey开发团队确认并修复。修复方案涉及正确处理FormData对象中的多个同名键，确保所有值都能被包含在请求中。

开发者建议

对于需要使用GM_xmlhttpRequest发送数组数据的开发者，建议：

1. 更新到包含此修复的Violentmonkey版本
2. 在脚本中明确检查FormData的处理行为
3. 考虑在关键功能中添加回退逻辑，确保兼容性

总结

这个案例展示了API兼容性的重要性，特别是当提供与原生API功能相似的扩展API时。Violentmonkey团队对此问题的快速响应体现了对脚本开发者体验的重视，确保了用户脚本在各种场景下的可靠运行。