Violentmonkey中GM.xmlHttpRequest访问WSL文件系统的Bug解析

问题背景

在Windows Subsystem for Linux(WSL)环境下使用Violentmonkey扩展时，开发者发现通过GM.xmlHttpRequest方法访问WSL文件系统路径时会出现异常。具体表现为：当尝试访问形如file://wsl.localhost/Ubuntu-24.04/test.txt的WSL路径时，请求会被错误地转换为HTTP协议而非保持原有的文件协议。

问题现象

开发者测试了两种不同的文件路径访问方式：

1. 访问本地C盘文件（成功）：

GM.xmlHttpRequest({
    method: "GET",
    url: "file:///C:/test.txt",
    // 处理逻辑
});

2. 访问WSL文件（失败）：

GM.xmlHttpRequest({
    method: "GET",
    url: "file://wsl.localhost/Ubuntu-24.04/test.txt",
    // 处理逻辑
});

后者会将URL错误地转换为http://wsl.localhost/Ubuntu-24.04/test.txt，导致请求失败。

技术分析

经过深入排查，发现问题根源在于浏览器内置的URL API在处理不同格式的文件URL时的行为不一致：

1. 对于标准文件路径file:///path，即使尝试修改协议为HTTP，URL对象仍会保持原有的file:协议

Object.assign(new URL('file:///foo.txt'), {protocol: 'http:'}).href
// 输出: file:///foo.txt

2. 对于WSL特有的file://host/path格式，修改协议的操作会生效

Object.assign(new URL('file://host/foo.txt'), {protocol: 'http:'}).href
// 输出: http://host/foo.txt

这种不一致的行为导致了Violentmonkey在处理WSL路径时出现协议转换错误。

解决方案

Violentmonkey开发团队通过修改URL处理逻辑修复了此问题。修复方案主要针对URL协议处理部分，确保在处理WSL特有的文件路径格式时能正确保持file:协议。

开发者可以验证修复效果的方式：

1. 使用修复后的版本进行测试
2. 在Violentmonkey的开发者工具控制台中直接使用XMLHttpRequest或fetch API测试WSL路径访问

技术启示

这个案例揭示了几个重要的技术点：

1. 浏览器对URL协议的处理可能存在边缘情况，特别是对于非标准路径格式
2. WSL文件系统访问在浏览器扩展开发中需要特殊考虑
3. 直接使用浏览器内置API时要注意其在不同场景下的行为差异

对于需要在浏览器扩展中访问特殊文件路径的开发者，建议：

• 充分测试各种路径格式
• 了解浏览器API的底层行为
• 考虑使用多种方法实现相同功能以增加兼容性

该问题的解决展示了开源社区快速响应和修复问题的能力，也为类似场景下的开发提供了有价值的参考。