WebSocket API使用变量配置主题时无法正常工作

核心问题定位 #

固定主题路径/notifications/room1能正常映射为/notifications?identifier=room1并工作，但使用变量路径/notifications/{roomID}、映射配置为/notifications?identifier={uri.var.roomID}时失效，问题出在变量的解析、传递或匹配环节。

排查与解决步骤 #

• 检查变量解析时机：多数网关或WebSocket框架要求路径变量在路由匹配阶段完成解析，如果映射配置是在连接建立后才替换变量，会导致identifier拿到的是字符串{uri.var.roomID}而非实际值。调整路由优先级，确保带变量的主题路径先被匹配，同时确认框架支持的变量语法（比如部分框架用${roomID}而非{uri.var.roomID}）。
• 确认主题匹配规则：避免主题路径与HTTP路由重叠，防止请求被错误分流到HTTP处理逻辑。部分协议（如STOMP、MQTT）的WebSocket实现需要显式声明主题是带变量的模板，而非普通路径。
• 验证变量传递链路：抓包检查客户端发起的连接请求中，identifier参数是否已被正确替换为实际roomID值；检查网关转发规则，确保开启了路径变量传递功能（比如Spring Cloud Gateway需配置参数传递规则）。
• 排查服务端订阅逻辑：确认服务端订阅的是/notifications/*这类通配符主题，还是支持/notifications/{roomID}模板匹配；自定义WebSocket实现要检查代码中解析identifier参数的逻辑，确保从请求参数中拿到真实值，而非模板字符串。

快速验证方法 #

1. 手动构造请求：ws://your-domain/notifications?identifier=testroom，确认连接和消息收发正常，排除参数本身的问题。
2. 测试固定变量路径/notifications/testroom，看是否能正确映射到notifications?identifier=testroom，验证路由映射的正确性。

内容的提问来源于stack exchange，提问作者Andres Tinoco