自定义Spring Boot Jar包作为依赖导入后出现NoSuchBeanDefinitionException异常的排查求助

你遇到的NoSuchBeanDefinitionException是典型的Spring容器无法识别依赖Jar包中Bean的问题，我整理了几个最常见的原因和对应的解决办法，帮你排查：

1. 主项目组件扫描范围未覆盖Jar包的包路径 #

Spring Boot默认只会扫描主启动类所在包及其子包下的组件。你的主项目包是com.example.demo，而Jar包中的类在com.xyz.digital路径下，不在默认扫描范围内，所以Spring找不到IridiumService的实现类。

解决办法：
在主项目的启动类上扩展扫描范围：

@SpringBootApplication(scanBasePackages = {"com.example.demo", "com.xyz.digital"})
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

或者单独用@ComponentScan指定多包：

@ComponentScan(basePackages = {"com.example.demo", "com.xyz.digital"})
@SpringBootApplication
public class DemoApplication { ... }

2. Jar包中的Service实现类未添加Spring组件注解 #

虽然你的Jar单独运行正常，但要确认IridiumService的实现类上标注了@Service、@Component这类Spring组件注解——没有这些注解，即使扫描范围覆盖了，Spring也不会把它注册为Bean。

检查示例：
打开Jar包中的实现类，确认顶部有类似注解：

@Service
public class IridiumServiceImpl implements IridiumService {
    // 业务逻辑实现
}

3. Jar包被打包成了可执行Jar而非普通依赖Jar #

Spring Boot的spring-boot-maven-plugin默认会生成可执行Jar，这种Jar的类文件放在BOOT-INF/classes目录下，结构和普通依赖Jar不同，作为依赖导入时主项目无法正确加载里面的类。

解决办法：
修改Jar项目的Maven配置，生成普通依赖Jar：
在Jar项目的pom.xml中给插件添加classifier配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <classifier>exec</classifier> <!-- 给可执行Jar加后缀标识 -->
            </configuration>
        </plugin>
    </plugins>
</build>

打包后会生成两个Jar：iridium-1.0.jar（普通依赖Jar，用于导入其他项目）和iridium-1.0-exec.jar（可执行Jar，用于单独运行），确保主项目导入的是不带-exec后缀的Jar。

4. 依赖注入的字段命名规范问题 #

注意到你的代码中字段名首字母大写：

@Autowired
IridiumService IridiumService;

虽然Spring支持这种写法，但按照Java规范字段名应该小写开头（iridiumService），避免潜在的注入匹配问题，建议修改为：

@Autowired
IridiumService iridiumService;

可以先从第1、2、3点开始排查，这三个是最常见的诱因，大概率能解决你的问题。

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