SpringBoot整合WebSocket测试常见错误与解决方法

问题描述

ja vax.websocket.server.ServerContainer not a vailable

免费看电影的app☜☜☜☜☜点击保存

问题起因

在使用SpringBoot框架进行开发时，通过@SpringBootTest注解执行单元测试，默认情况下它会加载所有由IoC容器管理的Bean，相当于创建了一个完整的应用上下文。理想状态下，这应该足以支撑各类功能的测试。

然而，问题恰恰出现在Web环境的配置上。由于Web服务是常用的测试对象，@SpringBootTest注解特意设计了webEnvironment参数来指定Web环境的类型，共包含以下四种选项：

• MOCK：默认选项，提供模拟（Mock）的Web环境，可配合@AutoConfigureMockMvc或@AutoConfigureWebTestClient进行HTTP测试。需注意：该模式下内嵌的Servlet容器并未真正启动，也不监听任何端口，因此WebSocket相关的容器服务不可用——报错原因即在于此。
• RANDOM_PORT：启动一个真实的Web服务，监听一个随机端口。
• DEFINED_PORT：启动一个真实的Web服务，监听application.properties中配置的端口。
• NONE：启动一个非Web的ApplicationContext，既不提供Mock环境，也不启动真实Web服务。

简而言之，开发者在编写测试类时未显式设置webEnvironment属性，导致使用了默认的MOCK模式。WebSocket功能依赖真实的Servlet容器才能正常运作，因此触发了该异常。

解决方案

解决方式很简单，只需在@SpringBootTest注解中明确指定一个真实的Web环境即可，示例如下：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.DEFINED_PORT)
class BilibiliApplicationTests {
    // 测试代码
}

或选择RANDOM_PORT模式，效果相同——核心在于让内嵌的Servlet容器真实启动并运行。

总结

该问题的本质在于测试环境与生产环境之间的差异。默认的Mock模式对大多数Web测试场景非常友好，然而一旦涉及WebSocket这类需要真实Servlet容器支持的功能，就必须手动调整环境配置。希望本文的经验能帮助遇到相同报错的开发者快速定位并解决问题。