Quarkus配置quarkus.http.root-path后无法建立WebSocket连接如何解决

问题根因 #

配置quarkus.http.root-path属性后，Quarkus会自动为所有暴露的HTTP端点（包含WebSocket端点）添加配置的根路径前缀，客户端沿用无自定义根路径时的旧连接地址就会出现404，导致连接失败。

可行解决方案 #

• 方案1：直接修改客户端连接地址
  按根路径 + 原有WebSocket路径的格式拼接新连接地址即可。比如你配置的quarkus.http.root-path=/api，原有WebSocket连接地址是ws://127.0.0.1:8080/msg，修改后的地址应为ws://127.0.0.1:8080/api/msg。
• 方案2：服务端动态匹配根路径，避免硬编码
  如果你用@ServerEndpoint注解声明WebSocket端点，可直接在注解中使用配置占位符自动适配根路径，示例如下：

  @ServerEndpoint("${quarkus.http.root-path}/msg")
  public class MsgWebSocket {
    // 业务逻辑
  }
  

  后续调整quarkus.http.root-path时无需手动修改端点路径，客户端按拼接后的规则连接即可。
• 方案3：反向代理层做路径重写（无需修改客户端代码）
  如果是通过Nginx等反向代理访问服务，不想修改客户端已有连接逻辑，可在代理配置中新增路径重写规则，将客户端发送的原始WebSocket路径自动补全根路径前缀后再转发给Quarkus服务。

验证提示 #

配置完成后可先查看Quarkus启动日志，或访问DevUI的端点列表页，确认WebSocket端点的实际暴露路径和客户端连接路径一致即可。

内容的提问来源于stack exchange，提问作者zander shrestha