Spring Boot无法扫描MongoRepository，依赖注入失败求助

1. 定义的ServerRepository代码 #

package org.prithvidiamond1.DB.Repositories;

import org.prithvidiamond1.DB.Models.SomeModel;
import org.springframework.data.mongodb.repository.MongoRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface ServerRepository extends MongoRepository<SomeModel, String> {
}

2. 启动报错信息 #

Exception encountered during context initialization - cancelling refresh attempt:
org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'botApplication': 
Unsatisfied dependency expressed through constructor parameter 0; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: 
No qualifying bean of type 'org.prithvidiamond1.DB.Repositories.ServerRepository' available: expected at least 1 bean which qualifies as autowire candidate.
Dependency annotations: {}


APPLICATION FAILED TO START
***************************

Description:

Parameter 0 of constructor in org.prithvidiamond1.BotApplication required a bean of type 'org.prithvidiamond1.DB.Repositories.ServerRepository' that could not be found.


Action:

Consider defining a bean of type 'org.prithvidiamond1.DB.Repositories.ServerRepository' in your configuration.

3. 项目目录结构 #

org.prithvidiamond1
   |
   +--BotApplication.java
   |
   +--DB
      |
      +--Repository
      |
      +--ServerRepository.java

4. BotApplication代码 #

package org.prithvidiamond1;

import org.jc.api.Api;
import org.jc.api.ApiBuilder;
import org.jc.api.entity.server.Server;
import org.prithvidiamond1.DB.Models.Server;
import org.prithvidiamond1.DB.Repositories.ServerRepository;
import org.slf4j.Logger;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;

import java.util.Collection;

@Component
public class BotApplication {
    private final Api api;
    private final ServerRepository serverRepository;

    public BotApplication(ServerRepository serverRepository, Logger logger){
        String botToken = System.getenv().get("BOT_TOKEN");

        this.api = new ApiBuilder();

        this.serverRepository = serverRepository;

        appRuntime(logger);
    }

    public void appRuntime(Logger logger){
        logger.info("Bot has started!");

        // Handling server entries in the database
        if (this.serverRepository.findAll().isEmpty()) {
            logger.trace("server data repository empty, initializing data repository...");
            Collection<Server> servers = api.getServers();
            for (Server server : servers) {
                this.serverRepository.save(new Server(String.valueOf(server.getId())));
            }
            logger.trace("server data repository initialized");
        }
    }

    @Bean
    public Api getApi() {
        return this.api;
    }
}

问题原因 #

1. Repository泛型类型错误：ServerRepository继承MongoRepository时使用了SomeModel，而非实际需要的Server模型类，导致Spring无法生成正确的Repository实现Bean。
2. 缺少Spring Data MongoDB启用注解：Spring Boot需要通过@EnableMongoRepositories注解扫描并自动创建MongoRepository的实现类，当前项目未配置该注解。
3. 无标准Spring Boot启动类：BotApplication仅标注@Component，缺少@SpringBootApplication注解，无法触发Spring Boot的自动配置和包扫描机制。
4. 类名冲突：BotApplication中导入了两个同名的Server类（第三方API模型和自定义DB模型），会导致编译或运行时类型混淆。

修复方法 #

步骤1：修正Repository泛型 #

修改ServerRepository代码，将泛型替换为正确的DB模型类：

package org.prithvidiamond1.DB.Repositories;

import org.prithvidiamond1.DB.Models.Server;
import org.springframework.data.mongodb.repository.MongoRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface ServerRepository extends MongoRepository<Server, String> {
}

步骤2：添加Spring Boot启动类 #

创建带启动注解的类，触发自动配置和Repository扫描：

package org.prithvidiamond1;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.mongodb.repository.config.EnableMongoRepositories;

@SpringBootApplication
@EnableMongoRepositories(basePackages = "org.prithvidiamond1.DB.Repositories")
public class DiamondBotApplication {
    public static void main(String[] args) {
        SpringApplication.run(DiamondBotApplication.class, args);
    }
}

步骤3：解决类名冲突 #

在BotApplication中为导入的同名类设置别名，避免混淆：

package org.prithvidiamond1;

import org.jc.api.Api;
import org.jc.api.ApiBuilder;
import org.jc.api.entity.server.Server as JcServer;
import org.prithvidiamond1.DB.Models.Server as DbServer;
import org.prithvidiamond1.DB.Repositories.ServerRepository;
import org.slf4j.Logger;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;

import java.util.Collection;

@Component
public class BotApplication {
    private final Api api;
    private final ServerRepository serverRepository;

    public BotApplication(ServerRepository serverRepository, Logger logger){
        String botToken = System.getenv().get("BOT_TOKEN");

        this.api = new ApiBuilder();

        this.serverRepository = serverRepository;

        appRuntime(logger);
    }

    public void appRuntime(Logger logger){
        logger.info("Bot has started!");

        // Handling server entries in the database
        if (this.serverRepository.findAll().isEmpty()) {
            logger.trace("server data repository empty, initializing data repository...");
            Collection<JcServer> servers = api.getServers();
            for (JcServer server : servers) {
                this.serverRepository.save(new DbServer(String.valueOf(server.getId())));
            }
            logger.trace("server data repository initialized");
        }
    }

    @Bean
    public Api getApi() {
        return this.api;
    }
}

步骤4：确认依赖正确性 #

检查项目构建文件中是否包含Spring Data MongoDB依赖：
Maven（pom.xml）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-mongodb</artifactId>
</dependency>

Gradle（build.gradle）：

implementation 'org.springframework.boot:spring-boot-starter-data-mongodb'

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