WalletWasabi Windows平台下Clearnet连接BlockstreamInfo费率服务异常分析

问题背景

在WalletWasabi钱包项目中，用户报告了一个在Windows平台上出现的特定问题：当关闭Tor网络使用Clearnet直接连接时，从BlockstreamInfo获取费率预估的服务会抛出异常。这个问题直接影响了用户发送交易的功能，因为系统无法获取到有效的手续费估算数据。

错误现象分析

当用户禁用Tor并启动WalletWasabi时，系统日志显示以下关键错误信息：

1. JSON解析异常：系统尝试解析从BlockstreamInfo获取的响应数据时失败，提示"<"是无效的JSON值起始字符
2. 后续影响：由于无法获取费率估算，导致发送交易功能完全不可用
3. 替代方案验证：当用户切换到MempoolSpace作为费率提供者时，功能恢复正常

根本原因

经过技术团队深入分析，发现问题根源在于HTTP请求头中的User-Agent设置。具体表现为：

1. Windows平台特有的行为：该问题仅在Windows系统上可重现，其他平台表现正常
2. 请求头验证失败：当包含User-Agent头时，BlockstreamInfo服务返回了非JSON格式的响应（可能是HTML错误页面）
3. 临时解决方案验证：通过移除User-Agent头，请求能够正常返回200状态码和正确的JSON数据

技术细节

在WalletWasabi的费率估算模块中，系统通过以下流程获取费率数据：

1. 创建HTTP客户端并设置User-Agent
2. 向BlockstreamInfo API发起请求
3. 尝试解析返回的JSON数据

问题出在第一步，Windows平台下设置的User-Agent头可能触发了BlockstreamInfo服务器的某些过滤机制，导致返回了错误响应而非预期的JSON数据。

解决方案建议

针对这一问题，技术团队提出了以下解决方案：

1. 默认使用MempoolSpace作为费率提供者：由于其在各种环境下表现更稳定
2. 改进User-Agent处理：重新评估User-Agent字符串的生成逻辑，确保其符合各服务提供商的接受标准
3. 增强错误处理：在JSON解析前增加响应内容验证，提供更有意义的错误信息
4. 平台特定适配：针对Windows平台实现特殊的请求头处理逻辑

对用户的影响

这一问题的存在意味着：

1. Windows用户在使用Clearnet连接时可能无法正常使用发送功能
2. 临时解决方案是手动切换到MempoolSpace作为费率提供者
3. 长期来看，开发团队需要确保各平台和各网络连接方式下的功能一致性

总结

WalletWasabi在Windows平台下使用Clearnet连接BlockstreamInfo服务时出现的这一问题，揭示了跨平台开发中请求头处理的复杂性。通过这次事件，开发团队将更加重视不同平台和网络环境下的服务兼容性测试，确保所有用户都能获得一致的使用体验。