Spring Boot 2.2启用懒加载后WebSocket端点无法连接求助

我之前也碰到过类似的问题，社区里不少用户也反馈过Spring Boot 2.2+开启全局懒加载后WebSocket端点无法正常工作的情况，下面给你拆解原因和可行的解决方案：

问题根源 #

Spring Boot 2.2引入的spring.main.lazy-initialization=true全局懒加载模式，会让Spring容器默认只在Bean被依赖时才初始化。而WebSocket的核心配置类（比如实现WebSocketMessageBrokerConfigurer的类）是靠框架扫描完成端点注册的，这类Bean通常没有其他业务Bean直接依赖它——如果被懒加载，容器启动时不会主动初始化它，自然也就不会注册WebSocket端点。当客户端发起CONNECT请求时，服务器根本没有对应的端点处理，所以永远收不到CONNECTED响应。

可行解决方案 #

方案1：给WebSocket配置类强制禁用懒加载 #

找到你的WebSocketConfig类，添加@Lazy(false)注解，强制容器启动时就初始化这个配置类，确保WebSocket端点正常注册：

@Configuration
@EnableWebSocketMessageBroker
@Lazy(false) // 关键注解：禁用当前类的懒加载
public class WebSocketConfig implements WebSocketMessageBrokerConfigurer {

    @Override
    public void configureMessageBroker(MessageBrokerRegistry config) {
        config.enableSimpleBroker("/topic");
        config.setApplicationDestinationPrefixes("/app");
    }

    @Override
    public void registerStompEndpoints(StompEndpointRegistry registry) {
        registry.addEndpoint("/gs-guide-websocket").withSockJS();
    }
}

方案2：在配置文件中排除WebSocket相关类的懒加载 #

如果不想修改代码，可以在application.properties中指定不需要懒加载的类：

spring.main.lazy-initialization=true
# 替换成你实际的WebSocket配置类全限定名
spring.main.lazy-initialization.exclude=com.yourpackage.WebSocketConfig

方案3：确保消息代理相关Bean正常初始化 #

如果使用了内置消息代理（比如enableSimpleBroker），偶尔会出现代理相关Bean也被懒加载的情况。可以在配置类中显式声明相关Bean，或者同样给它们添加@Lazy(false)注解，保证消息代理能正常启动。

验证方式 #

按照上述任意一种方案修改后，重新启动应用，开启全局懒加载，再测试WebSocket连接：

1. 打开Chrome开发者工具的Network > WebSocket面板
2. 点击页面的"Connect"按钮，应该能看到CONNECT请求后收到CONNECTED响应，后续的消息收发也能正常工作。

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