Spring Data MongoDB Repository无法注入Jersey Service问题排查

我之前也踩过Jersey和Spring Data整合的注入坑，咱们一步步来定位问题：

核心原因推测 #

你遇到的taskRepository为null，本质是Spring容器没有正确管理你的Service或Repository实例，或者Jersey没有使用Spring的DI容器来获取Service对象，导致Jersey自己new了一个Service实例（而不是从Spring拿），自然没有注入Repository。

逐一排查步骤 #

1. 检查Spring与Jersey的整合配置是否到位 #

Jersey默认用HK2作为DI容器，必须让它和Spring的容器打通，否则Jersey无法获取Spring管理的Bean：

• 首先确保引入了Jersey-Spring整合依赖（比如jersey-spring4，对应Spring 4.x版本）；
• 在你的ResourceConfig类中，必须注册Spring的组件提供者：

@ApplicationPath("/api")
public class AppResourceConfig extends ResourceConfig {
    public AppResourceConfig() {
        // 扫描你的Resource类所在包
        packages("com.your.package.resource");
        // 注册Spring组件提供者，让Jersey使用Spring的DI
        register(org.glassfish.jersey.server.spring.SpringComponentProvider.class);
    }
}

• 如果是传统web.xml配置，还要添加Spring的上下文监听器，确保Spring容器先启动：

<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:spring-config.xml</param-value>
</context-param>

2. 确认Repository和Service的Spring注解正确 #

Spring只会管理带有特定注解的类，别漏了：

• Repository层：
  • 如果是Spring Data MongoDB的标准Repository，接口只需继承MongoRepository<Task, String>，不需要自己写实现（Spring会动态生成代理类）；
  • 如果是自定义实现类（比如你自己写了TaskRepositoryImpl），必须给实现类加@Repository注解，且接口命名要符合规范：比如自定义接口叫TaskRepositoryCustom，实现类叫TaskRepositoryCustomImpl，主接口TaskRepository继承MongoRepository和TaskRepositoryCustom，这样Spring才能识别并注入。
• Service层：你的TaskService必须加@Service或@Component注解，让Spring把它注册为Bean。

3. 检查Resource类的注入方式 #

你的API Resource类（比如处理createUser请求的类），必须通过Spring的@Autowired或JSR-330的@Inject注入Service，绝对不能手动new Service实例：

@Path("/users")
public class UserResource {
    // 正确方式：让Spring注入
    @Autowired
    private TaskService taskService;

    @POST
    @Path("/create")
    public Response createUser(User user) {
        taskService.createTask(user);
        return Response.ok().build();
    }
}

4. 排查自定义Binder的问题 #

你提到了“依赖绑定器”，如果是用HK2的AbstractBinder手动绑定Bean，很可能是这里出了问题：

• 不要手动new Service或Repository实例，而是从Spring上下文获取Bean后再绑定：

public class AppBinder extends AbstractBinder {
    @Override
    protected void configure() {
        // 从Spring上下文获取已注册的Bean
        TaskService taskService = WebApplicationContextUtils.getWebApplicationContext(
                ServletContextHolder.getServletContext()
        ).getBean(TaskService.class);
        bind(taskService).to(TaskService.class);
    }
}

不过更推荐的是用前面说的SpringComponentProvider，它会自动把Spring的Bean桥接到HK2，不需要手动写Binder。

常见异常对应解决 #

你提到的三类异常，大概率是以下情况：

• NullPointerException：Service实例不是Spring管理的，导致Repository未注入；
• NoSuchBeanDefinitionException：Repository或Service没有加Spring注解，或者Spring扫描包配置错误；
• IllegalStateException：Jersey和Spring容器未整合，导致无法获取Spring Bean。

按照上面的步骤逐一排查，应该能解决问题。

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