uWebSockets中HTTP方法下划线处理问题解析

在uWebSockets项目中，开发者遇到了一个关于HTTP方法名称处理的特殊问题。当使用包含下划线的自定义HTTP方法时，如RDG_DATA_OUT，系统会将其转换为包含删除控制字符(0x7F)的字符串，导致方法名被破坏。

问题现象

开发者发现，当调用getMethod()或getCaseSensitiveMethod()方法获取请求的HTTP方法时，包含下划线的自定义方法名会被转换为异常形式。例如，RDG_DATA_OUT会被转换为类似rdg<delete>data<delete>out的形式，其中下划线被替换为删除控制字符(0x7F)。

技术背景

根据HTTP/1.1规范(RFC 9110)，HTTP方法名称被定义为"token"，规范中明确允许使用下划线字符。方法名称在技术上是大小写敏感的，尽管标准方法通常使用大写字母。

在uWebSockets的实现中，存在两种获取HTTP方法的方式：

1. getMethod()：为向后兼容而设计，会对方法名进行转换处理
2. getCaseSensitiveMethod()：保留原始大小写形式的方法名

问题根源

深入分析表明，问题的关键在于两种方法调用顺序的影响：

1. 如果仅调用getCaseSensitiveMethod()，可以正确获取原始方法名
2. 但如果先调用getMethod()，它会修改内部状态，导致后续所有获取方法名的操作都返回被转换后的形式

这种设计可能是出于性能优化考虑，避免重复解析，但导致了方法名被意外修改的问题。

解决方案

对于需要使用自定义HTTP方法（特别是包含下划线的）的应用，建议：

1. 始终优先使用getCaseSensitiveMethod()获取方法名
2. 避免在同一请求中混合使用两种获取方法的方式
3. 如果确实需要兼容性方法，确保调用顺序不会破坏原始方法名

最佳实践

在处理自定义HTTP方法时，开发者应当：

1. 明确了解应用场景是否需要严格保留方法名大小写
2. 在代码中保持一致的获取方法策略
3. 对接收到的自定义方法名进行充分验证
4. 考虑在应用层添加方法名规范化处理

这个问题特别提醒我们，在使用网络库时，对于非标准HTTP元素（如自定义方法）的处理需要格外小心，应当仔细阅读相关文档并充分测试边界情况。