Gravitee & WebSockets问题：HTTP请求头未传递至后端服务器

我之前在处理Gravitee 3.x版本的WebSocket头传递问题时遇到过类似情况，结合你提到的Keyless认证方案、3.15.3版本场景，分享几个亲测有效的排查和解决方法：

1. 检查API的头传递白名单配置 #

进入Gravitee控制台找到你的WebSocket API，导航到Proxy > Headers配置页：

• 首先确认是否开启了Pass through headers全局开关，如果开启了，默认应该传递大部分头，但敏感头（比如Authorization、Cookie）可能被默认过滤
• 如果全局开关没生效，手动添加需要传递的头到Allowed headers列表，明确指定Authorization和Cookie，确保网关不会拦截这些头

2. 针对WebSocket Upgrade阶段添加头转换策略 #

WebSocket连接是通过HTTP Upgrade请求初始化的，这个阶段的头处理逻辑和普通HTTP请求略有不同：

• 进入API的Flows配置，为WebSocket Upgrade阶段添加一个Header Transformation策略
• 在策略配置中选择Copy from request to proxy模式，分别添加Authorization和Cookie两个头名称，强制网关将客户端的这两个头复制到转发给后端的请求中

3. 升级到3.15系列的补丁版本 #

Gravitee 3.15.3确实存在WebSocket场景下的头传递已知bug，尤其是Keyless认证模式下的敏感头丢失问题。官方在3.15.8及后续补丁版本中修复了这个问题，如果你暂时无法升级到更高大版本，可以尝试升级到同系列的最新补丁版，大概率能解决问题。

4. 日志调试定位问题 #

如果以上方法都没生效，建议开启网关调试日志排查：

• 修改Gravitee网关的logback.xml配置文件，将io.gravitee.gateway的日志级别调整为DEBUG
• 重启网关后，观察WebSocket Upgrade请求的日志，查看客户端发送的头是否被网关正确接收，以及转发到后端时的头是否缺失
• 也可以在控制台的Analytics > Logs中查看请求详情，对比客户端请求头和网关转发头的差异

内容的提问来源于stack exchange，提问作者Apolo-11