Caddy服务器WebSocket配置在HTTP/2环境下的兼容性问题解析

Caddy服务器从2.8.4版本升级到2.9.1版本后，部分WebSocket配置出现了兼容性问题。这个问题主要源于HTTP/2协议对WebSocket连接处理方式的改变，导致原有的配置方式在新版本中失效。

在Caddy 2.8.4及更早版本中，开发者通常使用header Upgrade websocket这样的匹配规则来识别WebSocket请求。这种配置方式在HTTP/1.1环境下工作良好，因为HTTP/1.1使用Upgrade头部字段来协商协议升级。然而，HTTP/2采用了不同的机制来处理WebSocket连接，它使用:protocol: websocket这样的伪头部字段来指示协议升级。

当用户升级到Caddy 2.9.1后，如果客户端使用HTTP/2协议建立WebSocket连接，原有的基于Upgrade头部的匹配规则将不再有效。这会导致WebSocket请求被错误地路由到普通HTTP处理流程，而不是预期的WebSocket处理程序。

要解决这个问题，开发者需要使用新的匹配表达式来同时支持HTTP/1.1和HTTP/2的WebSocket连接。推荐的解决方案是使用CEL表达式：

expression header({'Upgrade': 'websocket'}) || header({':protocol': 'websocket'})

这个表达式会检查两种可能的WebSocket指示标志：传统的Upgrade头部和HTTP/2特有的:protocol伪头部。这样配置后，无论是通过HTTP/1.1还是HTTP/2建立的WebSocket连接都能被正确识别和处理。

对于需要保持向后兼容性的项目，开发者可以考虑在配置中同时保留新旧两种匹配方式，或者使用条件判断来根据Caddy版本选择适当的配置策略。值得注意的是，这个问题凸显了在支持多种HTTP协议版本时，开发者需要考虑不同协议间的行为差异。

Caddy团队建议开发者更新他们的WebSocket配置以适应HTTP/2环境，同时也表示未来可能会引入更简洁的语法来简化这种常见场景的配置工作。