SpringBoot中WebSocket的UserMapper注入为null问题求助

以下是针对你遇到的UserMapper实例为null问题的常见排查方向及解决方法：

1. WebSocket类未纳入Spring容器管理 #

如果你的WebSocket处理器（比如继承TextWebSocketHandler或使用@ServerEndpoint注解的类）没有被Spring的组件注解标记，Spring不会自动为其注入依赖，导致Mapper实例为空。

• 解决方法：
  • 若使用Spring原生WebSocket方案，给处理器类添加@Component注解，确保被Spring扫描并管理。
  • 若使用JSR-356标准的@ServerEndpoint，需同时标记@Component，并配置ServerEndpointExporter Bean：

    @Configuration
    public class WebSocketConfig {
        @Bean
        public ServerEndpointExporter serverEndpointExporter() {
            return new ServerEndpointExporter();
        }
    }
    

2. 手动实例化WebSocket类导致注入失效 #

如果代码中通过new关键字手动创建WebSocket处理器实例，而非从Spring容器获取，Spring无法为该实例注入依赖，自然会出现Mapper为null的情况。

• 解决方法：确保WebSocket实例由Spring容器创建，比如通过@Autowired注入，或在配置类中声明为Bean。

3. Mapper接口未正确配置 #

MyBatis-Plus无法生成Mapper代理类时，Spring也无法注入有效实例，常见原因包括：

• UserMapper未继承BaseMapper接口；
• 未给UserMapper添加@Mapper注解；
• 启动类未添加@MapperScan指定Mapper扫描路径。
• 解决方法：
  • 让UserMapper继承BaseMapper并添加@Mapper注解：

    @Mapper
    public interface UserMapper extends BaseMapper<User> {
        User getUserByUid(Long uid);
    }
    

  • 或在SpringBoot启动类上添加@MapperScan("com.xxx.mapper")（替换为你的Mapper所在包路径）。

4. 手动从Spring上下文获取Bean #

若WebSocket类的生命周期特殊，无法通过自动注入获取依赖，可手动从Spring上下文获取Mapper实例：

• 先创建Spring上下文工具类：

  @Component
  public class SpringContextUtil implements ApplicationContextAware {
      private static ApplicationContext applicationContext;
  
      @Override
      public void setApplicationContext(ApplicationContext context) throws BeansException {
          applicationContext = context;
      }
  
      public static <T> T getBean(Class<T> clazz) {
          return applicationContext.getBean(clazz);
      }
  }
  

• 然后在WebSocket中使用：

  UserMapper userMapper = SpringContextUtil.getBean(UserMapper.class);
  User user = userMapper.getUserByUid(uid);
  

5. 代理或事务注解冲突 #

如果WebSocket类添加了@Transactional等代理注解，可能导致依赖注入失效，尤其是使用JDK动态代理时（类未实现接口）。

• 解决方法：移除WebSocket类上不必要的事务注解；若必须使用代理，可配置Spring使用CGLIB代理（在配置类添加@EnableAspectJAutoProxy(proxyTargetClass = true)）。

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