SpringBoot依赖Jar中Repository Bean无法创建问题求助

核心原因 #

saveDataAPI启动时，Spring容器默认仅扫描自身主启动类所在包及其子包的Bean，DSM模块中的DSMMRepository（属于Spring Data Couchbase Repository）不在扫描范围内，导致依赖注入失败；同时，Spring Data的Repository需要通过专门的注解开启扫描，普通的@ComponentScan无法覆盖。

解决方法 #

方法1：在saveDataAPI主启动类添加扫描注解（快速生效）

在saveDataAPI的主启动类上，同时添加@ComponentScan（扫描DSM的Component）和@EnableCouchbaseRepositories（扫描DSM的Repository）：

@SpringBootApplication
// 同时扫描当前应用和DSM模块的包
@ComponentScan(basePackages = {"com.ums.sam.saveDataAPI", "com.ums.sam.DSMModule"})
// 专门扫描DSM模块的Repository包
@EnableCouchbaseRepositories(basePackages = "com.ums.sam.DSMModule.repo")
public class SaveDataApiApplication {
    public static void main(String[] args) {
        SpringApplication.run(SaveDataApiApplication.class, args);
    }
}

方法2：在DSM模块配置自动配置（推荐，符合SpringBoot规范）

这种方式不需要修改saveDataAPI的代码，DSM模块自身提供自动配置能力：

1. 在DSM模块的src/main/resources/META-INF/spring/目录下创建文件org.springframework.boot.autoconfigure.AutoConfiguration.imports，内容为DSM自动配置类的全路径：

com.ums.sam.DSMModule.config.DSMAutoConfiguration

2. 创建DSMAutoConfiguration类，统一管理DSM模块的Bean扫描：

@Configuration
// 扫描DSM模块的Component类（用basePackageClasses避免硬编码包名）
@ComponentScan(basePackageClasses = DSMController.class)
// 开启DSM模块的Couchbase Repository扫描
@EnableCouchbaseRepositories(basePackageClasses = DSMMRepository.class)
public class DSMAutoConfiguration {
    // 若DSM模块需要自定义Couchbase连接配置，可在此添加相关Bean
}

saveDataAPI引入DSM的Jar后，SpringBoot会自动加载该配置类，无需额外配置。

方法3：验证DSM的Jar打包完整性

解压DSM生成的Jar文件，确认以下内容存在：

• com/ums/sam/DSMModule/repo/DSMMRepository.class
• com/ums/sam/DSMModule/[component包路径]/DSMController.class
  若缺失，检查DSM模块的Maven配置，确保没有排除这些类的打包：

<!-- 确保DSM的pom.xml中没有类似排除配置 -->
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <!-- 若打包为普通Jar（非可执行Jar），需移除executions配置 -->
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

额外注意事项 #

• 确认DSM模块中的DSMMRepository正确继承了CouchbaseRepository，Spring Data会自动将其注册为Bean，但必须配合@EnableCouchbaseRepositories生效。
• 确认saveDataAPI的pom.xml中正确引入DSM依赖，版本与DSM打包版本一致：

<dependency>
    <groupId>com.ums.sam</groupId>
    <artifactId>DSMModule</artifactId>
    <version>1.0.0</version>
</dependency>

内容的提问来源于stack exchange，提问作者Manu S Nair