Trunk项目WebSocket代理HTTP方法错误问题分析

在Trunk项目0.21.0-rc5版本中，开发者报告了一个关于WebSocket代理功能的严重问题。当配置WebSocket代理时，系统会抛出"WrongHttpMethod"错误，导致WebSocket连接无法建立。

问题现象

开发者在使用0.21.0-rc5版本时，配置了如下代理设置：

[[proxy]]
backend = "ws://[::1]:8000/api/v1/ws"
request_headers = { "host" = "example.org" }
ws = true

运行时系统报错：

ERROR error establishing WebSocket connection to backend ws://[::1]:8000/api/v1/ws for proxy error=Protocol(WrongHttpMethod)

值得注意的是，这个问题在0.21.0-rc4版本中并不存在，表明这是rc5版本引入的回归问题。

问题根源

经过项目维护者的深入调查，发现问题出在内部函数创建请求时使用了错误的HTTP方法。虽然理论上这个方法会被覆盖为GET方法，但在实际网络通信中，错误的HTTP方法仍然被传递到了后端服务。

维护者最初在调试时犯了一个常见错误——只检查了WebSocket客户端和后端之间的通信，而没有检查Trunk和后端之间的通信。正确的排查方式应该是捕获Trunk和后端之间的网络数据包。

解决方案

项目维护者迅速响应，提交了修复代码。修复的核心是确保在WebSocket握手阶段使用正确的HTTP GET方法。这个修复已经包含在0.21.0-rc6版本中，开发者确认该版本确实解决了这个问题。

技术启示

这个案例展示了几个重要的开发实践：

1. 版本升级需要谨慎，即使是小的版本号变更也可能引入回归问题
2. 网络调试时要明确监控点，不同位置的抓包可能显示不同的问题现象
3. WebSocket握手阶段对HTTP方法有严格要求，必须使用GET方法
4. 完善的错误报告机制有助于快速定位问题

对于使用Trunk项目的开发者，建议在升级版本前检查变更日志，特别是涉及网络代理和WebSocket功能的修改。同时，在遇到类似问题时，可以通过网络抓包工具来辅助诊断问题发生的具体位置。