SpringBoot无法从自定义库导入Service/Component的问题解决

我创建了一个用于存储通用DTO、自定义异常及各类工具类的「starter项目」，将其作为所有项目的依赖，这样更新类时无需逐个修改项目。我把该项目打包成jar后，在其他项目中通过以下方式引入：

implementation files('../my-library/jar/my-library-1.0.jar')

但尝试使用库中的Service或Component时出现错误：

org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'com.nob234.mylibrary.services.MyService' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {}
    at org.springframework.beans.factory.support.DefaultListableBeanFactory.raiseNoMatchingBeanFound(DefaultListableBeanFactory.java:1801) ~[spring-beans-5.3.25.jar:5.3.25]

库中的Service代码如下：

@Service
@AllArgsConstructor
public class MyService {
    public String addSomething(String string){
        return string + " something";
    }
}

我在另一个项目的Service中尝试注入它：

@Service
@AllArgsConstructor
public class AnotherService {

    private final MyService myService;

    public String printHelloSomething() {
      return myService.addSomething("Hello");
    }
}

我猜测问题并非构造函数缺失，而是Spring @Service/@Component的上下文扫描存在问题，请问该如何解决？

你的猜测正确，核心问题是Spring容器未扫描到依赖jar包中的@Service/@Component类，导致这些类未被实例化为Bean。可通过以下方式解决：

1. 在主项目中指定扫描依赖包路径 #

在主项目的启动类上添加@ComponentScan注解，明确包含依赖库的包路径（需同时保留主项目自身包路径，避免内部Bean无法被扫描）：

@SpringBootApplication
@ComponentScan(basePackages = {"com.your.mainproject", "com.nob234.mylibrary"})
public class MainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

2. 用Spring自动配置机制规范starter（推荐） #

既然是starter项目，遵循Spring Boot Starter规范可实现依赖引入后自动加载Bean：

• 在starter库的src/main/resources/META-INF目录下创建spring.factories文件
• 在文件中配置自动配置类路径：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.nob234.mylibrary.config.MyLibraryAutoConfiguration

• 创建自动配置类，指定扫描库内包路径：

@Configuration
@ComponentScan(basePackages = "com.nob234.mylibrary")
public class MyLibraryAutoConfiguration {
}

主项目引入该starter后，Spring会自动读取spring.factories触发配置，扫描并加载库中的Bean。

3. 验证jar包打包内容 #

确认打包后的jar包包含：

• 编译后的MyService.class等目标文件
• 若使用Lombok的@AllArgsConstructor，需通过反编译class文件验证构造函数已生成

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