Tomcat WebSocket BufferOverflowException：大OAuth2令牌的兼容方案问询

这个问题我之前在做微服务网关WebSocket代理时也碰到过，核心就是Tomcat WebSocket容器默认的4096字节缓冲区太小，装不下带长OAuth2令牌的CONNECT请求头。给你几个实用的解决方案：

1. 直接调整Tomcat WebSocket缓冲区大小 #

这是最直接有效的方案，把缓冲区调大到能容纳你的Bearer令牌即可：

• Spring Boot配置文件方式：在application.yml或application.properties里添加配置：

  # 设置文本和二进制消息的缓冲区大小，这里设为16K，可根据你的令牌长度调整
  server.tomcat.websocket.max-text-message-buffer-size=16384
  server.tomcat.websocket.max-binary-message-buffer-size=16384
  

• 代码自定义配置方式：如果是手动创建StandardWebSocketClient，可以直接修改底层容器的参数：

  StandardWebSocketClient webSocketClient = new StandardWebSocketClient();
  WsWebSocketContainer container = (WsWebSocketContainer) webSocketClient.getWebSocketContainer();
  // 设置足够大的缓冲区，比如16KB
  container.setMaxTextMessageBufferSize(16384);
  container.setMaxBinaryMessageBufferSize(16384);
  

2. 优化OAuth2令牌的长度 #

如果调整缓冲区不是最优选择（比如担心过大缓冲区带来的资源问题），可以从令牌本身入手：

• 精简JWT内容：如果用的是JWT令牌，检查里面的claim字段，去掉不必要的信息，只保留身份认证和授权必需的内容，减少令牌的整体长度。
• 改用Reference Token：把长JWT换成短的Reference Token，网关只需传递这个短令牌，后端服务通过它向授权服务器查询完整的用户信息。这种方式能大幅缩短请求头里的令牌长度，从根源上避免缓冲区溢出。

3. 更换WebSocket客户端实现 #

如果不想依赖Tomcat的配置，可以考虑替换掉StandardWebSocketClient：

• 比如使用Jetty的WebSocketClient，它的缓冲区配置更灵活，默认限制也更高，能更好地适配长令牌场景。

内容的提问来源于stack exchange，提问作者Szabó László